預定義常數

以下常數由此擴充定義，並且只有在擴充已編譯到 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 (int)

傳遞給 pg_fetch_array()。返回一個包含欄位名稱和值的關聯式陣列。

PGSQL_NUM (int)

傳遞給 pg_fetch_array()。返回一個以數字索引的欄位編號和值的陣列。

PGSQL_BOTH (int)

傳遞給 pg_fetch_array()。返回一個同時以數字索引（依欄位編號）和關聯式（依欄位名稱）的欄位值陣列。

PGSQL_CONNECT_FORCE_NEW (int)

傳遞給 pg_connect() 以強制建立新的連線，而不是重複使用現有的相同連線。

PGSQL_CONNECT_ASYNC (int)

傳遞給 pg_connect() 以建立非同步連線。

PGSQL_CONNECTION_AUTH_OK (int)

PGSQL_CONNECTION_AWAITING_RESPONSE (int)

PGSQL_CONNECTION_BAD (int)

pg_connection_status() 返回的狀態，表示資料庫連線處於無效狀態。

PGSQL_CONNECTION_MADE (int)

PGSQL_CONNECTION_OK (int)

pg_connection_status() 返回的狀態，表示資料庫連線處於有效狀態。

PGSQL_CONNECTION_SETENV (int)

PGSQL_CONNECTION_SSL_STARTUP (int)

PGSQL_CONNECTION_STARTED (int)

PGSQL_SEEK_SET (int)

傳遞給 pg_lo_seek()。搜尋操作將從物件的開頭開始。

PGSQL_SEEK_CUR (int)

傳遞給 pg_lo_seek()。搜尋操作將從目前位置開始。

PGSQL_SEEK_END (int)

傳遞給 pg_lo_seek()。搜尋操作將從物件的結尾開始。

PGSQL_EMPTY_QUERY (int 整數)

由 pg_result_status() 回傳。傳送到伺服器的字串是空的。

PGSQL_COMMAND_OK (int 整數)

由 pg_result_status() 回傳。 指令成功完成，但未回傳任何資料。

PGSQL_TUPLES_OK (int 整數)

由 pg_result_status() 回傳。 指令成功完成，且回傳資料（例如 SELECT 或 SHOW）。

PGSQL_TUPLES_CHUNK (int 整數)

由 pg_result_status() 回傳。表示以分塊模式回傳資料的指令已成功完成。當設定了 pg_set_chunked_rows_size() 時，會針對 SELECT 指令回傳此值。結果集會被分成多個區塊，每個區塊包含預先定義的列數。PHP 8.4.0 和 libpq 17 以上版本可用。

PGSQL_COPY_OUT (int 整數)

由 pg_result_status() 回傳。 複製輸出（從伺服器）資料傳輸已開始。

PGSQL_COPY_IN (int 整數)

由 pg_result_status() 回傳。 複製輸入（到伺服器）資料傳輸已開始。

PGSQL_BAD_RESPONSE (int 整數)

由 pg_result_status() 回傳。 無法理解伺服器的回應。

PGSQL_NONFATAL_ERROR (int 整數)

由 pg_result_status() 回傳。 發生非致命錯誤（通知或警告）。

PGSQL_FATAL_ERROR (int 整數)

由 pg_result_status() 回傳。 發生致命錯誤。

PGSQL_TRANSACTION_IDLE (int 整數)

由 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 (整數)

傳遞給 pg_result_error_field()。 報告錯誤的 PostgreSQL 原始碼位置之檔案名稱。

PGSQL_DIAG_SOURCE_LINE (整數)

傳遞給 pg_result_error_field()。 報告錯誤的 PostgreSQL 原始碼位置之行號。

PGSQL_DIAG_SOURCE_FUNCTION (整數)

傳遞給 pg_result_error_field()。 報告錯誤的 PostgreSQL 原始碼函式名稱。

PGSQL_DIAG_SCHEMA_NAME (整數)

PHP 7.3.0 起可用。

PGSQL_DIAG_TABLE_NAME (整數)

PHP 7.3.0 起可用。

PGSQL_DIAG_COLUMN_NAME (整數)

PHP 7.3.0 起可用。

PGSQL_DIAG_DATATYPE_NAME (整數)

PHP 7.3.0 起可用。

PGSQL_DIAG_CONSTRAINT_NAME (整數)

PHP 7.3.0 起可用。

PGSQL_ERRORS_TERSE (整數)

傳遞給 pg_set_error_verbosity()。 指定傳回的訊息僅包含嚴重性、主要文字和位置；這通常適合單行顯示。

PGSQL_ERRORS_DEFAULT (整數)

傳遞給 pg_set_error_verbosity()。 預設模式產生的訊息包含上述內容以及任何詳細資訊、提示或上下文欄位（這些欄位可能跨越多行）。

PGSQL_ERRORS_VERBOSE (整數)

傳遞給 pg_set_error_verbosity()。 詳細模式包含所有可用的欄位。

PGSQL_ERRORS_SQLSTATE (整數)

傳遞給 pg_set_error_verbosity()。 僅包含錯誤嚴重性和 SQLSTATE 錯誤碼。 如果沒有可用的錯誤碼，則輸出與 PGSQL_ERRORS_TERSE 模式相同。 在 PostgreSQL 11.1 之前，輸出始終與 PGSQL_ERRORS_TERSE 模式相同。

PGSQL_NOTICE_LAST (整數)

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

PGSQL_NOTICE_ALL (整數)

由 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 (整數)

pg_connect_poll() 返回此值，表示連線嘗試失敗。

PGSQL_POLLING_READING (整數)

pg_connect_poll() 返回此值，表示連線正在等待 PostgreSQL 通訊端變為可讀取狀態。

PGSQL_POLLING_WRITING (整數)

pg_connect_poll() 返回此值，表示連線正在等待 PostgreSQL 通訊端變為可寫入狀態。

PGSQL_POLLING_OK (整數)

pg_connect_poll() 返回此值，表示連線已準備好可以使用。

PGSQL_POLLING_ACTIVE (整數)

pg_connect_poll() 返回此值，表示連線目前處於活動狀態。

PGSQL_DIAG_SEVERITY_NONLOCALIZED (整數)

嚴重性；欄位內容為 ERROR、FATAL 或 PANIC（在錯誤訊息中），或 WARNING、NOTICE、DEBUG、INFO 或 LOG（在通知訊息中）。這與 PG_DIAG_SEVERITY 欄位相同，除了內容永遠不會被本地化。此欄位僅存在於 9.6 版及更高版本 / PHP 7.3.0 及更高版本中。

PGSQL_SHOW_CONTEXT_NEVER (整數)

與 pg_set_error_context_visibility() 搭配使用，永遠不會顯示上下文。PHP 8.3.0 起可用。

PGSQL_SHOW_CONTEXT_ERRORS (整數)

與 pg_set_error_context_visibility() 搭配使用，上下文的欄位僅包含在錯誤訊息中。這是預設行為。PHP 8.3.0 起可用。

PGSQL_SHOW_CONTEXT_ALWAYS (整數)

與 pg_set_error_context_visibility() 搭配使用，上下文的欄位包含在錯誤、通知和警告訊息中。PHP 8.3.0 起可用。

PGSQL_TRACE_SUPPRESS_TIMESTAMPS (整數)

搭配 pg_trace() 使用時，追蹤訊息中不包含時間戳記。PHP 8.3.0 起可用。

PGSQL_TRACE_REGRESS_MODE (整數)

搭配 pg_trace() 使用時，追蹤訊息中會包含 OID 等欄位。PHP 8.3.0 起可用。