预定义常量

以下常量由此扩展定义，并且仅在将扩展编译到 PHP 中或在运行时动态加载时可用。

PGSQL_LIBPQ_VERSION (字符串)

仅包含数字和点的简短 libpq 版本。

PGSQL_LIBPQ_VERSION_STR (字符串)

在 PHP 8.0.0 之前，包含编译器信息的完整 libpq 版本。从 PHP 8.0.0 开始，该值与 PGSQL_LIBPQ_VERSION 相同，并且使用 PGSQL_LIBPQ_VERSION_STR 已弃用。

PGSQL_ASSOC (整数)

传递给 pg_fetch_array()。返回一个字段名和值的关联数组。

PGSQL_NUM (整数)

传递给 pg_fetch_array()。返回一个字段编号和值的数字索引数组。

PGSQL_BOTH (整数)

传递给 pg_fetch_array()。返回一个字段值数组，该数组既按数字索引（按字段编号），也按关联索引（按字段名称）。

PGSQL_CONNECT_FORCE_NEW (整数)

传递给 pg_connect() 以强制创建新的连接，而不是重新使用现有的相同连接。

PGSQL_CONNECT_ASYNC (整数)

传递给 pg_connect() 以创建异步连接。

PGSQL_CONNECTION_AUTH_OK (整数)

PGSQL_CONNECTION_AWAITING_RESPONSE (整数)

PGSQL_CONNECTION_BAD (整数)

由 pg_connection_status() 返回，表示数据库连接处于无效状态。

PGSQL_CONNECTION_MADE (整数)

PGSQL_CONNECTION_OK (整数)

由 pg_connection_status() 返回，表示数据库连接处于有效状态。

PGSQL_CONNECTION_SETENV (整数)

PGSQL_CONNECTION_SSL_STARTUP (整数)

PGSQL_CONNECTION_STARTED (整数)

PGSQL_SEEK_SET (整数)

传递给 pg_lo_seek()。查找操作从对象开头开始。

PGSQL_SEEK_CUR (整数)

传递给 pg_lo_seek()。查找操作从当前位置开始。

PGSQL_SEEK_END (整数)

传递给 pg_lo_seek()。查找操作从对象末尾开始。

PGSQL_EMPTY_QUERY (整数)

由 pg_result_status() 返回。发送到服务器的字符串为空。

PGSQL_COMMAND_OK (整数)

由 pg_result_status() 返回。成功完成不返回数据的命令。

PGSQL_TUPLES_OK (整数)

由 pg_result_status() 返回。成功完成返回数据（例如 SELECT 或 SHOW）的命令。

PGSQL_TUPLES_CHUNK (整数)

由 pg_result_status() 返回。指示成功完成以分块模式返回数据的命令。当设置 pg_set_chunked_rows_size() 时，对于 SELECT 命令返回。结果集被分成多个块，每个块包含预定义数量的行。从 PHP 8.4.0 和 libpq 17 开始可用。

PGSQL_COPY_OUT (整数)

由 pg_result_status() 返回。复制输出（从服务器）数据传输已开始。

PGSQL_COPY_IN (整数)

由 pg_result_status() 返回。复制输入（到服务器）数据传输已开始。

PGSQL_BAD_RESPONSE (整数)

由 pg_result_status() 返回。服务器的响应无法理解。

PGSQL_NONFATAL_ERROR (整数)

由 pg_result_status() 返回。发生了非致命错误（通知或警告）。

PGSQL_FATAL_ERROR (整数)

由 pg_result_status() 返回。发生了致命错误。

PGSQL_TRANSACTION_IDLE (整数)

由 pg_transaction_status() 返回。连接当前处于空闲状态，不在事务中。

PGSQL_TRANSACTION_ACTIVE (int)

由 pg_transaction_status() 返回。连接上正在执行命令。已通过连接发送查询，但尚未完成。

PGSQL_TRANSACTION_INTRANS (int)

由 pg_transaction_status() 返回。连接处于空闲状态，在事务块中。

PGSQL_TRANSACTION_INERROR (int)

由 pg_transaction_status() 返回。连接处于空闲状态，在失败的事务块中。

PGSQL_TRANSACTION_UNKNOWN (int)

由 pg_transaction_status() 返回。连接异常。

PGSQL_DIAG_SEVERITY (int)

传递给 pg_result_error_field()。严重性；字段内容为 ERROR、FATAL 或 PANIC（在错误消息中），或 WARNING、NOTICE、DEBUG、INFO 或 LOG（在通知消息中），或其中之一的本地化翻译。始终存在。

PGSQL_DIAG_SQLSTATE (int)

传递给 pg_result_error_field()。错误的 SQLSTATE 代码。SQLSTATE 代码标识发生的错误类型；前端应用程序可以使用它来执行特定操作（例如错误处理）以响应特定的数据库错误。此字段不可本地化，并且始终存在。

PGSQL_DIAG_MESSAGE_PRIMARY (int)

传递给 pg_result_error_field()。主要的人类可读错误消息（通常为一行）。始终存在。

PGSQL_DIAG_MESSAGE_DETAIL (int)

传递给 pg_result_error_field()。详细信息：一个可选的辅助错误消息，提供有关问题的更多详细信息。可能包含多行。

PGSQL_DIAG_MESSAGE_HINT (int)

传递给 pg_result_error_field()。提示：有关如何解决问题的可选建议。它旨在与详细信息有所不同，因为它提供建议（可能不合适）而不是硬性事实。可能包含多行。

PGSQL_DIAG_STATEMENT_POSITION (int)

传递给 pg_result_error_field()。一个包含十进制整数的字符串，指示错误光标位置作为原始语句字符串的索引。第一个字符的索引为 1，位置以字符而不是字节为单位测量。

PGSQL_DIAG_INTERNAL_POSITION (int)

传递给 pg_result_error_field()。这与 PG_DIAG_STATEMENT_POSITION 字段的定义相同，但它用于光标位置引用内部生成的命令而不是客户端提交的命令时。当此字段出现时，PG_DIAG_INTERNAL_QUERY 字段将始终出现。

PGSQL_DIAG_INTERNAL_QUERY (int)

传递给 pg_result_error_field()。失败的内部生成的命令的文本。例如，这可能是由 PL/pgSQL 函数发出的 SQL 查询。

PGSQL_DIAG_CONTEXT (int)

传递给 pg_result_error_field()。发生错误的上下文指示。目前，这包括活动过程语言函数和内部生成的查询的调用堆栈回溯。跟踪是每行一个条目，最近的条目排在最前面。

PGSQL_DIAG_SOURCE_FILE (int)

传递给 pg_result_error_field()。报告错误的 PostgreSQL 源代码位置的文件名。

PGSQL_DIAG_SOURCE_LINE (int)

传递给 pg_result_error_field()。报告错误的 PostgreSQL 源代码位置的行号。

PGSQL_DIAG_SOURCE_FUNCTION (int)

传递给 pg_result_error_field()。报告错误的 PostgreSQL 源代码函数的名称。

PGSQL_DIAG_SCHEMA_NAME (int)

自 PHP 7.3.0 起可用。

PGSQL_DIAG_TABLE_NAME (int)

自 PHP 7.3.0 起可用。

PGSQL_DIAG_COLUMN_NAME (int)

自 PHP 7.3.0 起可用。

PGSQL_DIAG_DATATYPE_NAME (int)

自 PHP 7.3.0 起可用。

PGSQL_DIAG_CONSTRAINT_NAME (int)

自 PHP 7.3.0 起可用。

PGSQL_ERRORS_TERSE (int)

传递给 pg_set_error_verbosity()。指定返回的消息仅包含严重性、主要文本和位置；这通常适合在一行中显示。

PGSQL_ERRORS_DEFAULT (int)

传递给 pg_set_error_verbosity()。默认模式生成的消息包括上述内容以及任何详细信息、提示或上下文字段（这些字段可能跨越多行）。

PGSQL_ERRORS_VERBOSE (int)

传递给 pg_set_error_verbosity()。详细模式包含所有可用字段。

PGSQL_ERRORS_SQLSTATE (int)

传递给 pg_set_error_verbosity()。仅包含错误严重性和 SQLSTATE 错误代码。如果不可用错误代码，则输出类似于 PGSQL_ERRORS_TERSE 模式。在 PostgreSQL 11.1 之前，输出始终与 PGSQL_ERRORS_TERSE 模式相同。

PGSQL_NOTICE_LAST (int)

由 pg_last_notice() 使用。自 PHP 7.1.0 起可用。

PGSQL_NOTICE_ALL (int)

由 pg_last_notice() 使用。自 PHP 7.1.0 起可用。

PGSQL_NOTICE_CLEAR (int)

由 pg_last_notice() 使用。自 PHP 7.1.0 起可用。

PGSQL_STATUS_LONG (int)

传递给 pg_result_status()。表示需要数值结果代码。

PGSQL_STATUS_STRING (int)

传递给 pg_result_status()。表示需要文本结果命令标签。

PGSQL_CONV_IGNORE_DEFAULT (int)

传递给 pg_convert()。在转换期间忽略表中的默认值。

PGSQL_CONV_FORCE_NULL (int)

传递给 pg_convert()。使用 SQL NULL 代替空 string。

PGSQL_CONV_IGNORE_NOT_NULL (int)

传递给 pg_convert()。忽略将 null 转换为 SQL NOT NULL 列。

PGSQL_DML_NO_CONV (int)

传递给 pg_insert()、pg_select()、pg_update() 和 pg_delete()。所有参数按原样传递。如果参数包含用户提供的数据，则需要手动转义。使用 pg_escape_string() 进行转义。

PGSQL_DML_EXEC (int)

传递给 pg_insert()、pg_select()、pg_update() 和 pg_delete()。由这些函数执行查询。

PGSQL_DML_ASYNC (int)

传递给 pg_insert()、pg_select()、pg_update() 和 pg_delete()。通过这些函数执行异步查询。

PGSQL_DML_STRING (int)

传递给 pg_insert()、pg_select()、pg_update() 和 pg_delete()。返回执行的查询字符串。

PGSQL_DML_ESCAPE (int)

传递给 pg_insert()、pg_select()、pg_update() 和 pg_delete()。对所有参数应用转义，而不是在内部调用 pg_convert()。此选项省略元数据查找。查询速度可能与 pg_query() 和 pg_send_query() 一样快。

PGSQL_POLLING_FAILED (int)

由 pg_connect_poll() 返回，表示连接尝试失败。

PGSQL_POLLING_READING (int)

由 pg_connect_poll() 返回，表示连接正在等待 PostgreSQL 套接字可读。

PGSQL_POLLING_WRITING (int)

由 pg_connect_poll() 返回，表示连接正在等待 PostgreSQL 套接字可写。

PGSQL_POLLING_OK (int)

由 pg_connect_poll() 返回，表示连接已准备好使用。

PGSQL_POLLING_ACTIVE (int)

由 pg_connect_poll() 返回，表示连接当前处于活动状态。

PGSQL_DIAG_SEVERITY_NONLOCALIZED (int)

严重性；字段内容为 ERROR、FATAL 或 PANIC（在错误消息中），或 WARNING、NOTICE、DEBUG、INFO 或 LOG（在通知消息中）。这与 PG_DIAG_SEVERITY 字段相同，只是内容从未本地化。这仅在 9.6 及更高版本/PHP 7.3.0 及更高版本中存在。

PGSQL_SHOW_CONTEXT_NEVER (int)

与 pg_set_error_context_visibility() 一起使用，上下文永远不会显示。从 PHP 8.3.0 开始可用。

PGSQL_SHOW_CONTEXT_ERRORS (int)

与 pg_set_error_context_visibility() 一起使用，上下文的字段仅包含在错误消息中。这是默认行为。从 PHP 8.3.0 开始可用。

PGSQL_SHOW_CONTEXT_ALWAYS (int)

与 pg_set_error_context_visibility() 一起使用，上下文的字段包含在错误、通知和警告消息中。从 PHP 8.3.0 开始可用。

PGSQL_TRACE_SUPPRESS_TIMESTAMPS (int)

与 pg_trace() 一起使用，时间戳不包含在跟踪消息中。从 PHP 8.3.0 开始可用。

PGSQL_TRACE_REGRESS_MODE (int)

与 pg_trace() 一起使用，跟踪消息中包含 OID 等字段。从 PHP 8.3.0 开始可用。