From feff053056fa2915779b121a696d516bf15c2971 Mon Sep 17 00:00:00 2001
From: Gina Peter Banyard <girgias.php.net>
Date: Sun, 12 Nov 2023 17:23:32 +0000
Subject: [PATCH 1/8] [PHP 8.3] pgsql update

---
 reference/pgsql/functions/pg-trace.xml | 1 +
 reference/pgsql/versions.xml           | 5 +++++
 2 files changed, 6 insertions(+)

diff --git a/reference/pgsql/functions/pg-trace.xml b/reference/pgsql/functions/pg-trace.xml
index a802480fcb96..17bd785c6f96 100644
--- a/reference/pgsql/functions/pg-trace.xml
+++ b/reference/pgsql/functions/pg-trace.xml
@@ -14,6 +14,7 @@
    <methodparam><type>string</type><parameter>filename</parameter></methodparam>
    <methodparam choice="opt"><type>string</type><parameter>mode</parameter><initializer>"w"</initializer></methodparam>
    <methodparam choice="opt"><type class="union"><type>PgSql\Connection</type><type>null</type></type><parameter>connection</parameter><initializer>&null;</initializer></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>trace_mode</parameter><initializer>0</initializer></methodparam>
   </methodsynopsis>
   <para>
    <function>pg_trace</function> enables tracing of the PostgreSQL
diff --git a/reference/pgsql/versions.xml b/reference/pgsql/versions.xml
index 134edaa08590..aaba7cdaa718 100644
--- a/reference/pgsql/versions.xml
+++ b/reference/pgsql/versions.xml
@@ -20,12 +20,14 @@
  <function name="pg_dbname" from="PHP 4, PHP 5, PHP 7, PHP 8"/>
  <function name="pg_delete" from="PHP 4 &gt;= 4.3.0, PHP 5, PHP 7, PHP 8"/>
  <function name="pg_end_copy" from="PHP 4 &gt;= 4.0.3, PHP 5, PHP 7, PHP 8"/>
+ <function name="pg_enter_pipeline_mode" from="PHP 8 &gt;= 8.3.0"/>
  <function name="pg_escape_bytea" from="PHP 4 &gt;= 4.2.0, PHP 5, PHP 7, PHP 8"/>
  <function name="pg_escape_identifier" from="PHP 5 &gt;= 5.4.4, PHP 7, PHP 8"/>
  <function name="pg_escape_literal" from="PHP 5 &gt;= 5.4.4, PHP 7, PHP 8"/>
  <function name="pg_escape_string" from="PHP 4 &gt;= 4.2.0, PHP 5, PHP 7, PHP 8"/>
  <function name="pg_exec" from="PHP 4, PHP 5, PHP 7, PHP 8"/>
  <function name="pg_execute" from="PHP 5 &gt;= 5.1.0, PHP 7, PHP 8"/>
+ <function name="pg_exit_pipeline_mode" from="PHP 8 &gt;= 8.3.0"/>
  <function name="pg_fetch_all" from="PHP 4 &gt;= 4.3.0, PHP 5, PHP 7, PHP 8"/>
  <function name="pg_fetch_all_columns" from="PHP 5 &gt;= 5.1.0, PHP 7, PHP 8"/>
  <function name="pg_fetch_array" from="PHP 4, PHP 5, PHP 7, PHP 8"/>
@@ -70,6 +72,8 @@
  <function name="pg_parameter_status" from="PHP 5, PHP 7, PHP 8"/>
  <function name="pg_pconnect" from="PHP 4, PHP 5, PHP 7, PHP 8"/>
  <function name="pg_ping" from="PHP 4 &gt;= 4.3.0, PHP 5, PHP 7, PHP 8"/>
+ <function name="pg_pipeline_status" from="PHP 8 &gt;= 8.3.0"/>
+ <function name="pg_pipeline_sync" from="PHP 8 &gt;= 8.3.0"/>
  <function name="pg_port" from="PHP 4, PHP 5, PHP 7, PHP 8"/>
  <function name="pg_prepare" from="PHP 5 &gt;= 5.1.0, PHP 7, PHP 8"/>
  <function name="pg_put_line" from="PHP 4 &gt;= 4.0.3, PHP 5, PHP 7, PHP 8"/>
@@ -85,6 +89,7 @@
  <function name="pg_send_query" from="PHP 4 &gt;= 4.2.0, PHP 5, PHP 7, PHP 8"/>
  <function name="pg_send_query_params" from="PHP 5 &gt;= 5.1.0, PHP 7, PHP 8"/>
  <function name="pg_set_client_encoding" from="PHP 4 &gt;= 4.0.3, PHP 5, PHP 7, PHP 8"/>
+ <function name="pg_set_error_context_visibility" from="PHP 8 &gt;= 8.3.0"/>
  <function name="pg_set_error_verbosity" from="PHP 5 &gt;= 5.1.0, PHP 7, PHP 8"/>
  <function name="pg_socket" from="PHP 5 &gt;= 5.6.0, PHP 7, PHP 8"/>
  <function name="pg_trace" from="PHP 4 &gt;= 4.0.1, PHP 5, PHP 7, PHP 8"/>

From 2e025e12b117e022975af9e3e3d903d0ade84b5a Mon Sep 17 00:00:00 2001
From: David CARLIER <devnexen@gmail.com>
Date: Sun, 12 Nov 2023 17:34:02 +0000
Subject: [PATCH 2/8] pg_set_error_context_visibility

---
 .../pg-set-error-context-visibility.xml       | 113 ++++++++++++++++++
 1 file changed, 113 insertions(+)
 create mode 100644 reference/pgsql/functions/pg-set-error-context-visibility.xml

diff --git a/reference/pgsql/functions/pg-set-error-context-visibility.xml b/reference/pgsql/functions/pg-set-error-context-visibility.xml
new file mode 100644
index 000000000000..647de3b7af46
--- /dev/null
+++ b/reference/pgsql/functions/pg-set-error-context-visibility.xml
@@ -0,0 +1,113 @@
+<?xml version="1.0" encoding="utf-8"?>
+<refentry xml:id="function.pg-set-error-context-visibility" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>pg_set_error_context_visibility</refname>
+  <refpurpose>
+   Determines the visibility of the context's error messages returned by <function>pg_last_error</function>
+   and <function>pg_result_error</function>
+  </refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>int</type><methodname>pg_set_error_context_visibility</methodname>
+   <methodparam><type>PgSql\Connection</type><parameter>connection</parameter></methodparam>
+   <methodparam><type>int</type><parameter>visibility</parameter></methodparam>
+  </methodsynopsis>
+  &warn.undocumented.func;
+  <para>
+   Determines the visibility of the context's error messages returned by <function>pg_last_error</function>
+   and <function>pg_result_error</function>
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>connection</parameter></term>
+     <listitem>
+      &pgsql.parameter.connection;
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>visibility</parameter></term>
+     <listitem>
+      <para>
+       The required visibility: <constant>PGSQL_SHOW_CONTEXT_NEVER</constant>,
+       <constant>PGSQL_SHOW_CONTEXT_ERRORS</constant>
+       or <constant>PGSQL_SHOW_CONTEXT_ALWAYS</constant>.
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   The previous visibility level: <constant>PGSQL_SHOW_CONTEXT_NEVER</constant>,
+   <constant>PGSQL_SHOW_CONTEXT_ERRORS</constant>
+   or <constant>PGSQL_SHOW_CONTEXT_ALWAYS</constant>.
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example xml:id="function.pg-set-error-context-visibility.example.basic">
+   <title><function>pg_set_error_context_visibility</function> example</title>
+   <para>
+    Description.
+   </para>
+   <programlisting role="php">
+<![CDATA[
+<?php
+  $dbconn = pg_connect("dbname=publisher") or die("Could not connect");
+
+  if (!pg_connection_busy($dbconn)) {
+      pg_send_query($dbconn, "select * from doesnotexist;");
+  }
+
+  pg_set_error_context_visibility($dbconn, PGSQL_SHOW_CONTEXT_ALWAYS);
+  $res1 = pg_get_result($dbconn);
+  echo pg_result_error($res1);
+?>
+]]>
+   </programlisting>
+  </example>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><function>pg_last_error</function></member>
+    <member><function>pg_result_error</function></member>
+   </simplelist>
+  </para>
+ </refsect1>
+</refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->

From a68425073013f0a964f06410521143eee0277413 Mon Sep 17 00:00:00 2001
From: David CARLIER <devnexen@gmail.com>
Date: Sun, 12 Nov 2023 17:53:48 +0000
Subject: [PATCH 3/8] pg_enter_pipeline_mode

---
 .../functions/pg-enter-pipeline-mode.xml      | 92 +++++++++++++++++++
 1 file changed, 92 insertions(+)
 create mode 100644 reference/pgsql/functions/pg-enter-pipeline-mode.xml

diff --git a/reference/pgsql/functions/pg-enter-pipeline-mode.xml b/reference/pgsql/functions/pg-enter-pipeline-mode.xml
new file mode 100644
index 000000000000..06d4977603af
--- /dev/null
+++ b/reference/pgsql/functions/pg-enter-pipeline-mode.xml
@@ -0,0 +1,92 @@
+<?xml version="1.0" encoding="utf-8"?>
+<refentry xml:id="function.pg-enter-pipeline-mode" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>pg_enter_pipeline_mode</refname>
+  <refpurpose>Causes a connection to enter pipeline mode if it is currently idle or already in pipeline mode</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>bool</type><methodname>pg_enter_pipeline_mode</methodname>
+   <methodparam><type>PgSql\Connection</type><parameter>connection</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   Causes a connection to enter pipeline mode if it is currently idle or already in pipeline mode
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>connection</parameter></term>
+     <listitem>
+      &pgsql.parameter.connection;
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Returns &true; if it succeeds to enter in pipeline mode or &false;
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example xml:id="function.pg-enter-pipeline-mode.example.basic">
+   <title><function>pg_enter_pipeline_mode</function> example</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+$dbconn = pg_connect("host=localhost port=5432 dbname=mary")
+   or die("Could not connect");
+echo pg_enter_pipeline_node($dbconn);
+pg_close($dbconn);
+?>
+]]>
+   </programlisting>
+   &example.outputs;
+   <screen>
+<![CDATA[
+false
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <simplelist>
+   <member><function>pg_connect</function></member>
+   <member><function>pg_connect_poll</function></member>
+   <member><function>pg_flush</function></member>
+  </simplelist>
+ </refsect1>
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->

From 3fbddbc2381d8586f3a8cfcaafaa36a036e35cc9 Mon Sep 17 00:00:00 2001
From: David CARLIER <devnexen@gmail.com>
Date: Sun, 12 Nov 2023 20:18:15 +0000
Subject: [PATCH 4/8] pg_exit_pipeline_mode

---
 .../pgsql/functions/pg-exit-pipeline-mode.xml | 95 +++++++++++++++++++
 1 file changed, 95 insertions(+)
 create mode 100644 reference/pgsql/functions/pg-exit-pipeline-mode.xml

diff --git a/reference/pgsql/functions/pg-exit-pipeline-mode.xml b/reference/pgsql/functions/pg-exit-pipeline-mode.xml
new file mode 100644
index 000000000000..c0f38dc24200
--- /dev/null
+++ b/reference/pgsql/functions/pg-exit-pipeline-mode.xml
@@ -0,0 +1,95 @@
+<?xml version="1.0" encoding="utf-8"?>
+<refentry xml:id="function.pg-exit-pipeline-mode" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>pg_exit_pipeline_mode</refname>
+  <refpurpose>Causes a connection to exit pipeline mode if it is currently in pipeline mode with an empty queue and no pending results.</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>bool</type><methodname>pg_exit_pipeline_mode</methodname>
+   <methodparam><type>PgSql\Connection</type><parameter>connection</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   Causes a connection to exit pipeline mode if it is currently in pipeline mode with an empty queue and no pending results.escription.
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>connection</parameter></term>
+     <listitem>
+      &pgsql.parameter.connection;
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Returns &true; if it succeeds to exit the pipeline mode, assuming
+   it was in this mode via <function>pg_enter_pipeline_mode</function>,
+   &false; otherwise.
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example xml:id="function.pg-exit-pipeline-mode.example.basic">
+   <title><function>pg_exit_pipeline_mode</function> example</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+$dbconn = pg_connect("host=localhost port=5432 dbname=mary")
+   or die("Could not connect");
+echo pg_exit_pipeline_node($dbconn);
+pg_close($dbconn);
+?>
+]]>
+   </programlisting>
+   &example.outputs;
+   <screen>
+<![CDATA[
+false
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <simplelist>
+   <member><function>pg_enter_pipeline_mode</function></member>
+   <member><function>pg_connect</function></member>
+   <member><function>pg_connect_poll</function></member>
+   <member><function>pg_flush</function></member>
+  </simplelist>
+ </refsect1>
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->

From 36b768d5ccf622b5e8f885b5e6151927fcda1411 Mon Sep 17 00:00:00 2001
From: David CARLIER <devnexen@gmail.com>
Date: Mon, 13 Nov 2023 18:51:25 +0000
Subject: [PATCH 5/8] changes from review

---
 reference/pgsql/functions/pg-enter-pipeline-mode.xml         | 5 +++--
 reference/pgsql/functions/pg-exit-pipeline-mode.xml          | 2 +-
 .../pgsql/functions/pg-set-error-context-visibility.xml      | 5 +----
 3 files changed, 5 insertions(+), 7 deletions(-)

diff --git a/reference/pgsql/functions/pg-enter-pipeline-mode.xml b/reference/pgsql/functions/pg-enter-pipeline-mode.xml
index 06d4977603af..7103a9781449 100644
--- a/reference/pgsql/functions/pg-enter-pipeline-mode.xml
+++ b/reference/pgsql/functions/pg-enter-pipeline-mode.xml
@@ -2,7 +2,7 @@
 <refentry xml:id="function.pg-enter-pipeline-mode" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>pg_enter_pipeline_mode</refname>
-  <refpurpose>Causes a connection to enter pipeline mode if it is currently idle or already in pipeline mode</refpurpose>
+  <refpurpose>Causes a connection to enter pipeline mode if it is currently idle.</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">
@@ -12,7 +12,7 @@
    <methodparam><type>PgSql\Connection</type><parameter>connection</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Causes a connection to enter pipeline mode if it is currently idle or already in pipeline mode
+   Causes a connection to enter pipeline mode if it is currently idle.
   </para>
  </refsect1>
 
@@ -63,6 +63,7 @@ false
  <refsect1 role="seealso">
   &reftitle.seealso;
   <simplelist>
+   <member><function>pg_exit_pipeline_mode</function></member>
    <member><function>pg_connect</function></member>
    <member><function>pg_connect_poll</function></member>
    <member><function>pg_flush</function></member>
diff --git a/reference/pgsql/functions/pg-exit-pipeline-mode.xml b/reference/pgsql/functions/pg-exit-pipeline-mode.xml
index c0f38dc24200..d859c749b966 100644
--- a/reference/pgsql/functions/pg-exit-pipeline-mode.xml
+++ b/reference/pgsql/functions/pg-exit-pipeline-mode.xml
@@ -12,7 +12,7 @@
    <methodparam><type>PgSql\Connection</type><parameter>connection</parameter></methodparam>
   </methodsynopsis>
   <para>
-   Causes a connection to exit pipeline mode if it is currently in pipeline mode with an empty queue and no pending results.escription.
+   Causes a connection to exit pipeline mode if it is currently in pipeline mode with an empty queue and no pending results.
   </para>
  </refsect1>
 
diff --git a/reference/pgsql/functions/pg-set-error-context-visibility.xml b/reference/pgsql/functions/pg-set-error-context-visibility.xml
index 647de3b7af46..4dc80de5053e 100644
--- a/reference/pgsql/functions/pg-set-error-context-visibility.xml
+++ b/reference/pgsql/functions/pg-set-error-context-visibility.xml
@@ -3,8 +3,7 @@
  <refnamediv>
   <refname>pg_set_error_context_visibility</refname>
   <refpurpose>
-   Determines the visibility of the context's error messages returned by <function>pg_last_error</function>
-   and <function>pg_result_error</function>
+   Determines the visibility of the context's error messages.
   </refpurpose>
  </refnamediv>
 
@@ -15,7 +14,6 @@
    <methodparam><type>PgSql\Connection</type><parameter>connection</parameter></methodparam>
    <methodparam><type>int</type><parameter>visibility</parameter></methodparam>
   </methodsynopsis>
-  &warn.undocumented.func;
   <para>
    Determines the visibility of the context's error messages returned by <function>pg_last_error</function>
    and <function>pg_result_error</function>
@@ -90,7 +88,6 @@
   </para>
  </refsect1>
 </refentry>
-
 <!-- Keep this comment at the end of the file
 Local variables:
 mode: sgml

From 2b4bf85bf8608792c58164249c08c492049b726a Mon Sep 17 00:00:00 2001
From: David CARLIER <devnexen@gmail.com>
Date: Mon, 13 Nov 2023 19:22:32 +0000
Subject: [PATCH 6/8] pg_pipeline_status

---
 .../pgsql/functions/pg-pipeline-status.xml    | 95 +++++++++++++++++++
 1 file changed, 95 insertions(+)
 create mode 100644 reference/pgsql/functions/pg-pipeline-status.xml

diff --git a/reference/pgsql/functions/pg-pipeline-status.xml b/reference/pgsql/functions/pg-pipeline-status.xml
new file mode 100644
index 000000000000..0af6a1f74a11
--- /dev/null
+++ b/reference/pgsql/functions/pg-pipeline-status.xml
@@ -0,0 +1,95 @@
+<?xml version="1.0" encoding="utf-8"?>
+<refentry xml:id="function.pg-pipeline-status" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>pg_pipeline_status</refname>
+  <refpurpose>Returns the current pipeline mode status of the libpq connection.</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>int</type><methodname>pg_pipeline_status</methodname>
+   <methodparam><type>PgSql\Connection</type><parameter>connection</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   Returns the current pipeline mode status of the libpq connection.
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>connection</parameter></term>
+     <listitem>
+      &pgsql.parameter.connection;
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Returns one of the following status:
+   <constant>PGSQL_PIPELINE_ON</constant>, <constant>PGSQL_PIPELINE_OFF</constant> or
+   <constant>PGSQL_PIPELINE_ABORTED</constant>.
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example xml:id="function.pg-pipeline-status.example.basic">
+   <title><function>pg_pipeline_status</function> example</title>
+   <para>
+    Description.
+   </para>
+   <programlisting role="php">
+<![CDATA[
+<?php
+$dbconn = pg_connect("host=localhost port=5432 dbname=mary")
+   or die("Could not connect");
+pg_enter_pipeline_node($dbconn);
+echo pg_pipeline_status($dbconn);
+pg_close($dbconn);
+?>
+]]>
+   </programlisting>
+   &example.outputs;
+   <screen>
+<![CDATA[
+0
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <simplelist>
+   <member><function>pg_enter_pipeline_mode</function></member>
+  </simplelist>
+ </refsect1>
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->

From f3ba78e58aaeef55cc1b98b93c35319318b84fc3 Mon Sep 17 00:00:00 2001
From: David CARLIER <devnexen@gmail.com>
Date: Mon, 13 Nov 2023 19:31:02 +0000
Subject: [PATCH 7/8] pg_pipeline_sync

---
 .../pgsql/functions/pg-pipeline-sync.xml      | 96 +++++++++++++++++++
 1 file changed, 96 insertions(+)
 create mode 100644 reference/pgsql/functions/pg-pipeline-sync.xml

diff --git a/reference/pgsql/functions/pg-pipeline-sync.xml b/reference/pgsql/functions/pg-pipeline-sync.xml
new file mode 100644
index 000000000000..cf63935e2bb0
--- /dev/null
+++ b/reference/pgsql/functions/pg-pipeline-sync.xml
@@ -0,0 +1,96 @@
+<?xml version="1.0" encoding="utf-8"?>
+<refentry xml:id="function.pg-pipeline-sync" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>pg_pipeline_sync</refname>
+  <refpurpose>Marks a synchronization point in a pipeline by sending a sync message and flushing the send buffer.</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type>bool</type><methodname>pg_pipeline_sync</methodname>
+   <methodparam><type>PgSql\Connection</type><parameter>connection</parameter></methodparam>
+  </methodsynopsis>
+  <para>
+   Marks a synchronization point in a pipeline by sending a sync message and flushing the send buffer.
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>connection</parameter></term>
+     <listitem>
+      &pgsql.parameter.connection;
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Returns &true; on success or &false;
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example xml:id="function.pg-pipeline-sync.example.basic">
+   <title><function>pg_pipeline_sync</function> example</title>
+   <para>
+    Description.
+   </para>
+   <programlisting role="php">
+<![CDATA[
+<?php
+$dbconn = pg_connect("host=localhost port=5432 dbname=publisher")
+   or die("Could not connect");
+pg_enter_pipeline_node($dbconn);
+pg_send_query($dbconn, "select * from authors; select count(*) from authors;");
+pg_flush($dbconn);
+echo pg_pipeline_sync($dbconn);
+pg_close($dbconn);
+?>
+]]>
+   </programlisting>
+   &example.outputs;
+   <screen>
+<![CDATA[
+false
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <simplelist>
+   <member><function>pg_enter_pipeline_mode</function></member>
+   <member><function>pg_pipeline_status</function></member>
+  </simplelist>
+ </refsect1>
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->

From 476156ca26e042077f28ca34f5fb7b61104566a3 Mon Sep 17 00:00:00 2001
From: Gina Peter Banyard <girgias@php.net>
Date: Tue, 14 Nov 2023 01:23:18 +0000
Subject: [PATCH 8/8] Update refpurpose

---
 reference/pgsql/functions/pg-exit-pipeline-mode.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/reference/pgsql/functions/pg-exit-pipeline-mode.xml b/reference/pgsql/functions/pg-exit-pipeline-mode.xml
index d859c749b966..276aeca2258e 100644
--- a/reference/pgsql/functions/pg-exit-pipeline-mode.xml
+++ b/reference/pgsql/functions/pg-exit-pipeline-mode.xml
@@ -2,7 +2,7 @@
 <refentry xml:id="function.pg-exit-pipeline-mode" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>pg_exit_pipeline_mode</refname>
-  <refpurpose>Causes a connection to exit pipeline mode if it is currently in pipeline mode with an empty queue and no pending results.</refpurpose>
+  <refpurpose>Causes a connection to exit pipeline mode</refpurpose>
  </refnamediv>
 
  <refsect1 role="description">