sigmasternchen/php-doc-en
1
0
Fork 0
mirror of https://github.com/sigmasternchen/php-doc-en synced 2025-03-15 16:38:54 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Officially deprecate ext/mysql in the manual.

Browse source 
Specific changes:

- Upgraded the soft deprecation sidebars to full blown warnings.
- Beefed up the wording of the soft deprecation notice boilerplate.
- Added changelog items for mysql_connect() and mysql_pconnect(), since they're
  the functions that have changed behaviour.
- Updated the MySQL changelog.
- Updated the 5.5 migration guide.


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@328734 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Adam Harvey 2012-12-10 15:22:07 +00:00
parent 32eae026d6
commit 65e697ff67
53 changed files with 209 additions and 153 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

12
appendices/migration55.xml
View file

@ -331,6 +331,18 @@ String dereferencing: P
<sect1 xml:id="migration55.deprecated">
<title>Deprecated features in PHP 5.5.x</title>
<sect2 xml:id="migration55.deprecated.mysql">
<title><link linkend="book.mysql">ext/mysql</link> deprecation</title>
<para>
The <link linkend="book.mysql">original MySQL extension</link> is now
deprecated, and will generate <constant>E_DEPRECATED</constant> errors
when connecting to a database. Instead, use the
<link linkend="book.mysqli">MySQLi</link> or
<link linkend="ref.pdo-mysql">PDO_MySQL</link> extensions.
</para>
</sect2>
<sect2 xml:id="migration55.deprecated.preg-replace-e">
<title><function>preg_replace</function> <literal>/e</literal> modifier</title>

8
language-snippets.ent
View file

@ -1167,10 +1167,10 @@ field_offset</parameter></term><listitem><para>The numerical field offset. The
<parameter>field_offset</parameter> does not exist, an error of level
<constant>E_WARNING</constant> is also issued.</para></listitem></varlistentry>'>
<!ENTITY mysql.alternative.note '<title xmlns="http://docbook.org/ns/docbook">Suggested alternatives</title>
<para xmlns="http://docbook.org/ns/docbook">Use of this extension is discouraged. Instead, the <link linkend="book.mysqli">MySQLi</link> or
<link linkend="ref.pdo-mysql">PDO_MySQL</link> extension should be used. See also <link linkend="mysqlinfo.api.choosing">MySQL:
choosing an API</link> guide and <link linkend="faq.databases.mysql.deprecated">related FAQ</link> for more information.
<!ENTITY mysql.alternative.note '<para xmlns="http://docbook.org/ns/docbook">This extension is deprecated as of PHP 5.5.0, and will be removed in the future.
Instead, the <link linkend="book.mysqli">MySQLi</link> or <link linkend="ref.pdo-mysql">PDO_MySQL</link> extension should be used.
See also <link linkend="mysqlinfo.api.choosing">MySQL: choosing an API</link> guide and
<link linkend="faq.databases.mysql.deprecated">related FAQ</link> for more information.
Alternatives to this function include:</para>'>
<!-- Sybase Notes -->

5
reference/mysql/book.xml
View file

@ -11,8 +11,9 @@
<preface xml:id="intro.mysql">
&reftitle.intro;
<para>
This extension is not recommended for writing new code. Instead,
either the <link linkend="book.mysqli">mysqli</link> or
This extension is deprecated as of PHP 5.5.0, and is not recommended for
writing new code as it will be removed in the future. Instead, either the
<link linkend="book.mysqli">mysqli</link> or
<link linkend="ref.pdo-mysql">PDO_MySQL</link> extension should be
used. See also the <link linkend="mysqlinfo.api.choosing">MySQL API
Overview</link> for further help while choosing a MySQL API.

15
reference/mysql/changelog.xml
View file

@ -40,7 +40,20 @@
<entry>5.5.0</entry>
<entry>
<para>
All of the old deprecated functions and aliases now emit E_DEPRECATED errors. These functions are:
This extension has been deprecated. Connecting to a MySQL database
via <function>mysql_connect</function>,
<function>mysql_pconnect</function> or an implicit connection via any
other <literal>mysql_*</literal> function will generate an
<constant>E_DEPRECATED</constant> error.
</para>
</entry>
</row>
<row>
<entry>5.5.0</entry>
<entry>
<para>
All of the old deprecated functions and aliases now emit
<constant>E_DEPRECATED</constant> errors. These functions are:
</para>
<para>
mysql(), mysql_fieldname(), mysql_fieldtable(), mysql_fieldlen(), mysql_fieldtype(), mysql_fieldflags(), mysql_selectdb(),

6
reference/mysql/functions/mysql-affected-rows.xml
View file

@ -6,14 +6,14 @@
<refpurpose>Get number of affected rows in previous MySQL operation</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member><function>mysqli_affected_rows</function></member>
<member><methodname>PDOStatement::rowCount</methodname></member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

6
reference/mysql/functions/mysql-client-encoding.xml
View file

@ -6,13 +6,13 @@
<refpurpose>Returns the name of the character set</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member><function>mysqli_character_set_name</function></member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

6
reference/mysql/functions/mysql-close.xml
View file

@ -6,14 +6,14 @@
<refpurpose>Close MySQL connection</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member><function>mysqli_close</function></member>
<member>PDO: Assign the value of &null; to the PDO object</member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

13
reference/mysql/functions/mysql-connect.xml
View file

@ -6,14 +6,14 @@
<refpurpose>Open a connection to a MySQL Server</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member><function>mysqli_connect</function></member>
<member><methodname>PDO::__construct</methodname></member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">
@ -126,6 +126,13 @@
</row>
</thead>
<tbody>
<row>
<entry>5.5.0</entry>
<entry>
This function will generate an <constant>E_DEPRECATED</constant>
error.
</entry>
</row>
<row>
<entry>4.3.0</entry>
<entry>

6
reference/mysql/functions/mysql-create-db.xml
View file

@ -6,14 +6,14 @@
<refpurpose>Create a MySQL database</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member><function>mysqli_query</function></member>
<member><methodname>PDO::query</methodname></member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

6
reference/mysql/functions/mysql-data-seek.xml
View file

@ -6,14 +6,14 @@
<refpurpose>Move internal result pointer</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member><function>mysqli_data_seek</function></member>
<member><constant>PDO::FETCH_ORI_ABS</constant></member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

6
reference/mysql/functions/mysql-db-name.xml
View file

@ -6,13 +6,13 @@
<refpurpose>Retrieves database name from the call to <function>mysql_list_dbs</function></refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member>Query: <literal>SELECT DATABASE()</literal></member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

6
reference/mysql/functions/mysql-db-query.xml
View file

@ -6,14 +6,14 @@
<refpurpose>Selects a database and executes a query on it</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member><function>mysqli_select_db</function> then the query</member>
<member><methodname>PDO::__construct</methodname></member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

6
reference/mysql/functions/mysql-drop-db.xml
View file

@ -6,13 +6,13 @@
<refpurpose>Drop (delete) a MySQL database</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member>Execute a <literal>DROP DATABASE</literal> query</member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

6
reference/mysql/functions/mysql-errno.xml
View file

@ -6,14 +6,14 @@
<refpurpose>Returns the numerical value of the error message from previous MySQL operation</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member><function>mysqli_errno</function></member>
<member><methodname>PDO::errorCode</methodname></member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

6
reference/mysql/functions/mysql-error.xml
View file

@ -6,14 +6,14 @@
<refpurpose>Returns the text of the error message from previous MySQL operation</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member><function>mysqli_error</function></member>
<member><methodname>PDO::errorInfo</methodname></member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

6
reference/mysql/functions/mysql-escape-string.xml
View file

@ -6,14 +6,14 @@
<refpurpose>Escapes a string for use in a mysql_query</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member><function>mysqli_escape_string</function></member>
<member><methodname>PDO::quote</methodname></member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

6
reference/mysql/functions/mysql-fetch-array.xml
View file

@ -6,14 +6,14 @@
<refpurpose>Fetch a result row as an associative array, a numeric array, or both</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member><function>mysqli_fetch_array</function></member>
<member><methodname>PDOStatement::fetch</methodname></member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

6
reference/mysql/functions/mysql-fetch-assoc.xml
View file

@ -6,14 +6,14 @@
<refpurpose>Fetch a result row as an associative array</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member><function>mysqli_fetch_assoc</function></member>
<member><methodname phd:args="PDO::FETCH_ASSOC">PDOStatement::fetch</methodname></member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

6
reference/mysql/functions/mysql-fetch-field.xml
View file

@ -6,14 +6,14 @@
<refpurpose>Get column information from a result and return as an object</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member><function>mysqli_fetch_field</function></member>
<member><methodname>PDOStatement::getColumnMeta</methodname></member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

6
reference/mysql/functions/mysql-fetch-lengths.xml
View file

@ -6,14 +6,14 @@
<refpurpose>Get the length of each output in a result</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member><function>mysqli_fetch_lengths</function></member>
<member><methodname>PDOStatement::getColumnMeta</methodname></member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

6
reference/mysql/functions/mysql-fetch-object.xml
View file

@ -6,14 +6,14 @@
<refpurpose>Fetch a result row as an object</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member><function>mysqli_fetch_object</function></member>
<member><methodname phd:args="PDO::FETCH_OBJ">PDOStatement::fetch</methodname></member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

6
reference/mysql/functions/mysql-fetch-row.xml
View file

@ -6,14 +6,14 @@
<refpurpose>Get a result row as an enumerated array</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member><function>mysqli_fetch_row</function></member>
<member><methodname phd:args="PDO::FETCH_NUM">PDOStatement::fetch</methodname></member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

6
reference/mysql/functions/mysql-field-flags.xml
View file

@ -6,14 +6,14 @@
<refpurpose>Get the flags associated with the specified field in a result</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member><function>mysqli_fetch_fields</function> [flags]</member>
<member><methodname>PDOStatement::getColumnMeta</methodname> [flags]</member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

6
reference/mysql/functions/mysql-field-len.xml
View file

@ -6,14 +6,14 @@
<refpurpose>Returns the length of the specified field</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member><function>mysqli_fetch_field_direct</function> [length]</member>
<member><methodname>PDOStatement::getColumnMeta</methodname> [len]</member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

6
reference/mysql/functions/mysql-field-name.xml
View file

@ -6,14 +6,14 @@
<refpurpose>Get the name of the specified field in a result</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member><function>mysqli_fetch_field_direct</function> [name] or [orgname]</member>
<member><methodname>PDOStatement::getColumnMeta</methodname> [name]</member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

6
reference/mysql/functions/mysql-field-seek.xml
View file

@ -6,15 +6,15 @@
<refpurpose>Set result pointer to a specified field offset</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member><function>mysqli_field_seek</function></member>
<!-- @TODO Expand on the following -->
<member><methodname>PDOStatement::fetch</methodname> using optional parameters</member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

6
reference/mysql/functions/mysql-field-table.xml
View file

@ -6,14 +6,14 @@
<refpurpose>Get name of the table the specified field is in</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member><function>mysqli_fetch_field_direct</function> [table] or [orgtable]</member>
<member><methodname>PDOStatement::getColumnMeta</methodname> [table]</member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

6
reference/mysql/functions/mysql-field-type.xml
View file

@ -6,14 +6,14 @@
<refpurpose>Get the type of the specified field in a result</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member><function>mysqli_fetch_field_direct</function> [type]</member>
<member><methodname>PDOStatement::getColumnMeta</methodname> [driver:decl_type] or [pdo_type]</member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

6
reference/mysql/functions/mysql-free-result.xml
View file

@ -6,14 +6,14 @@
<refpurpose>Free result memory</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member><function>mysqli_free_result</function></member>
<member>Assign the value of &null; to the PDO object, or <methodname>PDOStatement::closeCursor</methodname></member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

6
reference/mysql/functions/mysql-get-client-info.xml
View file

@ -6,14 +6,14 @@
<refpurpose>Get MySQL client info</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member><function>mysqli_get_client_info</function></member>
<member><methodname phd:args="PDO::ATTR_CLIENT_VERSION">PDO::getAttribute</methodname></member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

6
reference/mysql/functions/mysql-get-host-info.xml
View file

@ -6,14 +6,14 @@
<refpurpose>Get MySQL host info</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member><function>mysqli_get_host_info</function></member>
<member><methodname phd:args="PDO::ATTR_CONNECTION_STATUS">PDO::getAttribute</methodname></member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

6
reference/mysql/functions/mysql-get-proto-info.xml
View file

@ -6,13 +6,13 @@
<refpurpose>Get MySQL protocol info</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member><function>mysqli_get_proto_info</function></member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

6
reference/mysql/functions/mysql-get-server-info.xml
View file

@ -6,14 +6,14 @@
<refpurpose>Get MySQL server info</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member><function>mysqli_get_server_info</function></member>
<member><methodname phd:args="PDO::ATTR_SERVER_VERSION">PDO::getAttribute</methodname></member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

6
reference/mysql/functions/mysql-info.xml
View file

@ -6,13 +6,13 @@
<refpurpose>Get information about the most recent query</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member><function>mysqli_info</function></member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

6
reference/mysql/functions/mysql-insert-id.xml
View file

@ -6,14 +6,14 @@
<refpurpose>Get the ID generated in the last query</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member><function>mysqli_insert_id</function></member>
<member><methodname>PDO::lastInsertId</methodname></member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

6
reference/mysql/functions/mysql-list-dbs.xml
View file

@ -6,13 +6,13 @@
<refpurpose>List databases available on a MySQL server</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member>SQL Query: <literal>SHOW DATABASES</literal></member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

6
reference/mysql/functions/mysql-list-fields.xml
View file

@ -6,13 +6,13 @@
<refpurpose>List MySQL table fields</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member>SQL Query: <literal>SHOW COLUMNS FROM sometable</literal></member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

6
reference/mysql/functions/mysql-list-processes.xml
View file

@ -6,13 +6,13 @@
<refpurpose>List MySQL processes</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member><function>mysqli_thread_id</function></member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

6
reference/mysql/functions/mysql-list-tables.xml
View file

@ -6,13 +6,13 @@
<refpurpose>List tables in a MySQL database</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member>SQL Query: <literal>SHOW TABLES FROM sometable</literal></member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

6
reference/mysql/functions/mysql-num-fields.xml
View file

@ -6,14 +6,14 @@
<refpurpose>Get number of fields in result</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member><function>mysqli_field_count</function></member>
<member><methodname>PDOStatement::columnCount</methodname></member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

6
reference/mysql/functions/mysql-num-rows.xml
View file

@ -6,14 +6,14 @@
<refpurpose>Get number of rows in result</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member><function>mysqli_stmt_num_rows</function></member>
<member><methodname>PDOStatement::rowCount</methodname></member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

13
reference/mysql/functions/mysql-pconnect.xml
View file

@ -6,14 +6,14 @@
<refpurpose>Open a persistent connection to a MySQL server</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member><function>mysqli_connect</function> with <literal>p:</literal> host prefix</member>
<member><methodname>PDO::__construct</methodname> with <constant>PDO::ATTR_PERSISTENT</constant> as a driver option</member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">
@ -134,6 +134,13 @@
</row>
</thead>
<tbody>
<row>
<entry>5.5.0</entry>
<entry>
This function will generate an <constant>E_DEPRECATED</constant>
error.
</entry>
</row>
<row>
<entry>4.3.0</entry>
<entry>

6
reference/mysql/functions/mysql-ping.xml
View file

@ -6,13 +6,13 @@
<refpurpose>Ping a server connection or reconnect if there is no connection</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member><function>mysqli_ping</function></member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

6
reference/mysql/functions/mysql-query.xml
View file

@ -6,14 +6,14 @@
<refpurpose>Send a MySQL query</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member><function>mysqli_query</function></member>
<member><methodname>PDO::query</methodname></member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

6
reference/mysql/functions/mysql-real-escape-string.xml
View file

@ -6,14 +6,14 @@
<refpurpose>Escapes special characters in a string for use in an SQL statement</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member><function>mysqli_real_escape_string</function></member>
<member><methodname>PDO::quote</methodname></member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

14
reference/mysql/functions/mysql-result.xml
View file

@ -6,6 +6,20 @@
<refpurpose>Get result data</refpurpose>
</refnamediv>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member>
<function>mysqli_data_seek</function> in conjunction with
<function>mysqli_field_seek</function> and
<function>mysqli_fetch_field</function>
</member>
<member><methodname>PDOStatement::fetchColumn</methodname></member>
</simplelist>
</warning>
</refsynopsisdiv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>

6
reference/mysql/functions/mysql-select-db.xml
View file

@ -6,14 +6,14 @@
<refpurpose>Select a MySQL database</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member><function>mysqli_select_db</function></member>
<member><methodname>PDO::__construct</methodname> (part of dsn)</member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

6
reference/mysql/functions/mysql-set-charset.xml
View file

@ -6,14 +6,14 @@
<refpurpose>Sets the client character set</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member><function>mysqli_character_set_name</function></member>
<member>PDO: Add <literal>charset</literal> to the connection string, such as <literal>charset=utf8</literal></member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

6
reference/mysql/functions/mysql-stat.xml
View file

@ -6,14 +6,14 @@
<refpurpose>Get current system status</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member><function>mysqli_stat</function></member>
<member><methodname phd:args="PDO::ATTR_SERVER_INFO">PDO::getAttribute</methodname></member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

6
reference/mysql/functions/mysql-tablename.xml
View file

@ -6,13 +6,13 @@
<refpurpose>Get table name of field</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member>SQL Query: <literal>SHOW TABLES</literal></member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

6
reference/mysql/functions/mysql-thread-id.xml
View file

@ -6,13 +6,13 @@
<refpurpose>Return the current thread ID</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member><function>mysqli_thread_id</function></member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

6
reference/mysql/functions/mysql-unbuffered-query.xml
View file

@ -6,13 +6,13 @@
<refpurpose>Send an SQL query to MySQL without fetching and buffering the result rows.</refpurpose>
</refnamediv>
<refsynopsisdiv role="soft-deprecation-notice">
<sidebar>
<refsynopsisdiv>
<warning>
&mysql.alternative.note;
<simplelist role="alternatives">
<member>See: <link linkend="mysqlinfo.concepts.buffering">Buffered and Unbuffered queries</link></member>
</simplelist>
</sidebar>
</warning>
</refsynopsisdiv>
<refsect1 role="description">

12
reference/mysqlinfo/set.xml
View file

@ -199,10 +199,12 @@ echo htmlentities($row['_message']);
It is recommended to use either the <link linkend="book.mysqli">mysqli</link>
or <link linkend="ref.pdo-mysql">PDO_MySQL</link> extensions.
It is not recommended to use the old <link linkend="ref.mysql">mysql</link>
extension for new development. A detailed feature comparison matrix is provided
below. The overall performance of all three extensions is considered to be
about the same. Although the performance of the extension contributes only a fraction
of the total run time of a PHP web request. Often, the impact is as low as 0.1%.
extension for new development, as it has been deprecated as of PHP 5.5.0
and will be removed in the future. A detailed feature comparison matrix is
provided below. The overall performance of all three extensions is
considered to be about the same. Although the performance of the extension
contributes only a fraction of the total run time of a PHP web request.
Often, the impact is as low as 0.1%.
</para>
<para>
<emphasis role="bold">Feature comparison</emphasis>
@ -240,7 +242,7 @@ echo htmlentities($row['_message']);
<entry>Lifecycle</entry>
<entry>Active</entry>
<entry>Active</entry>
<entry>Long term deprecation announced</entry>
<entry>Deprecated</entry>
</row>
<row>
<entry>Recommended for new projects</entry>