Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 3 additions & 7 deletions reference/pdo/pdo/getattribute.xml
Original file line number Diff line number Diff line change
Expand Up @@ -38,18 +38,14 @@
One of the <literal>PDO::ATTR_*</literal> constants. The generic attributes that
apply to database connections are as follows:
<simplelist>
<member><literal>PDO::ATTR_AUTOCOMMIT</literal></member>
<member><literal>PDO::ATTR_CASE</literal></member>
<member><literal>PDO::ATTR_CLIENT_VERSION</literal></member>
<member><literal>PDO::ATTR_CONNECTION_STATUS</literal></member>
<member><literal>PDO::ATTR_DEFAULT_FETCH_MODE</literal></member>
<member><literal>PDO::ATTR_DRIVER_NAME</literal></member>
<member><literal>PDO::ATTR_ERRMODE</literal></member>
<member><literal>PDO::ATTR_ORACLE_NULLS</literal></member>
<member><literal>PDO::ATTR_PERSISTENT</literal></member>
<member><literal>PDO::ATTR_PREFETCH</literal></member>
<member><literal>PDO::ATTR_SERVER_INFO</literal></member>
<member><literal>PDO::ATTR_SERVER_VERSION</literal></member>
<member><literal>PDO::ATTR_TIMEOUT</literal></member>
<member><literal>PDO::ATTR_STATEMENT_CLASS</literal></member>
<member><literal>PDO::ATTR_STRINGIFY_FETCHES</literal></member>
Comment thread
kamil-tekiela marked this conversation as resolved.
Comment thread
lacatoire marked this conversation as resolved.
</simplelist>
</para>
<simpara>
Expand Down
21 changes: 15 additions & 6 deletions reference/pdo/pdo/prepare.xml
Original file line number Diff line number Diff line change
Expand Up @@ -56,12 +56,12 @@
</para>
<note>
<simpara>
The parser used for emulated prepared statements and for
rewriting named or question mark style parameters supports the non standard
backslash escapes for single- and double quotes. That means that terminating
quotes immediately preceded by a backslash are not recognized as such, which
may result in wrong detection of parameters causing the prepared statement to
fail when it is executed. A work-around is to not use emulated prepares for
Before PHP 8.4.0, the parser used for emulated prepared statements and for
rewriting named or question mark style parameters supported the non standard
backslash escapes for single- and double quotes. That meant that terminating
quotes immediately preceded by a backslash were not recognized as such, which
could result in wrong detection of parameters causing the prepared statement to
fail when it was executed. A work-around was to not use emulated prepares for
such SQL queries, and to avoid rewriting of parameters by using a parameter style
which is natively supported by the driver.
</simpara>
Expand All @@ -71,6 +71,15 @@
the <literal>??</literal> string will be translated to <literal>?</literal>
when sending the query to the database.
</para>
<simpara>
As of PHP 8.4.0, PDO uses driver-specific SQL parsers to locate parameter
markers, so that markers appearing inside string literals or comments are
not mistaken for placeholders. The default parser recognizes single- and
double-quoted string literals, as
well as two-dashes and non-nested C-style comments. Individual drivers may
provide a parser that recognizes additional or different syntax; refer to the
driver-specific documentation for details.
</simpara>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
Expand Down
7 changes: 7 additions & 0 deletions reference/pdo/pdostatement/getattribute.xml
Original file line number Diff line number Diff line change
Expand Up @@ -21,6 +21,13 @@
(Firebird and ODBC specific):
Get the name of cursor for <literal>UPDATE ... WHERE CURRENT OF</literal>.
</para></listitem>
<listitem>
<simpara>
<constant>Pdo\Pgsql::ATTR_RESULT_MEMORY_SIZE</constant>
(PostgreSQL specific, available as of PHP 8.4.0):
Get the amount of memory, in bytes, allocated to the query result.
</simpara>
</listitem>
</itemizedlist>
Note that driver specific attributes <emphasis>must not</emphasis> be used
with other drivers.
Expand Down
5 changes: 5 additions & 0 deletions reference/pdo_firebird/configure.xml
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,11 @@ $ ./configure --with-pdo-firebird
]]>
</screen>
</para>
<simpara>
As of PHP 8.4.0, this extension uses Firebird C++ APIs and therefore
requires a C++ compiler, and must be built against fbclient 3.0
or higher.
</simpara>
</section>

<!-- Keep this comment at the end of the file
Expand Down
4 changes: 4 additions & 0 deletions reference/pdo_pgsql/configure.xml
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,10 @@ $ ./configure --with-pdo-pgsql
]]>
</screen>
</para>
<simpara>
This extension requires libpq (the PostgreSQL C client library).
As of PHP 8.4.0, libpq 10.0 or later is required.
</simpara>
</section>

<!-- Keep this comment at the end of the file
Expand Down
8 changes: 8 additions & 0 deletions reference/pdo_pgsql/pdo-pgsql.xml
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,14 @@
</listitem>
</itemizedlist>
</para>
<note>
<simpara>
Because this parser recognizes dollar-quoted string literals, question
marks inside them are not treated as parameter placeholders and do not
need to be escaped. As of PHP 8.4.0, escaping question marks as
<literal>??</literal> inside a dollar-quoted string is deprecated.
</simpara>
</note>
Comment thread
kamil-tekiela marked this conversation as resolved.
</section>
<!-- }}} -->

Expand Down
9 changes: 9 additions & 0 deletions reference/pdo_pgsql/reference.xml
Original file line number Diff line number Diff line change
Expand Up @@ -119,6 +119,15 @@
</varlistentry>

</variablelist>
<note>
<simpara>
As of PHP 8.4.0, credentials specified in the DSN
(<literal>user</literal> and <literal>password</literal>) take priority
over the corresponding arguments passed to the
<classname>PDO</classname> constructor. In earlier versions, the
PDO constructor arguments took precedence.
</simpara>
</note>
Comment thread
kamil-tekiela marked this conversation as resolved.
<note>
<simpara>
All semicolons in the DSN string are replaced by spaces, because PostgreSQL
Expand Down