svn: /phpdoc/en/trunk/reference/mysqlinfo/ set.xml
| From: | Adam Harvey | Date: | Fri, 04 Dec 2015 01:27:29 +0000 |
| Subject: | svn: /phpdoc/en/trunk/reference/mysqlinfo/ set.xml | ||
| Groups: | php.doc.cvs | ||
| Request: | Send a blank email to doc-cvs+get-13872@lists.php.net to get a copy of this message | ||
aharvey Fri, 04 Dec 2015 01:27:29 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=338210
Log:
Strengthen wording around choosing a MySQL API now PHP 7 is out.
Changed paths:
U phpdoc/en/trunk/reference/mysqlinfo/set.xml
Modified: phpdoc/en/trunk/reference/mysqlinfo/set.xml
===================================================================
--- phpdoc/en/trunk/reference/mysqlinfo/set.xml 2015-12-03 22:43:22 UTC (rev 338209)
+++ phpdoc/en/trunk/reference/mysqlinfo/set.xml 2015-12-04 01:27:29 UTC (rev 338210)
@@ -25,9 +25,17 @@
<title>Introduction</title>
<abstract>
<para>
- There are three PHP APIs for accessing the MySQL database. This guide
- explains the <link linkend="mysqlinfo.terminology">terminology</link>
- used to describe each API, information about
+ Depending on the version of PHP, there are either two or three PHP APIs
+ for accessing the MySQL database. PHP 5 users can choose between the
+ deprecated <link linkend="book.mysql">mysql</link> extension,
+ <link linkend="book.mysqli">mysqli</link>, or
+ <link linkend="ref.pdo-mysql">PDO_MySQL</link>. PHP 7 removes the mysql
+ extension, leaving only the latter two options.
+ </para>
+ <para>
+ This guide explains the
+ <link linkend="mysqlinfo.terminology">terminology</link> used to
describe
+ each API, information about
<link linkend="mysqlinfo.api.choosing">choosing which API</link> to
use, and also information to help choose which MySQL
<link linkend="mysqlinfo.library.choosing">library to use</link> with
@@ -199,12 +207,12 @@
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, 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%.
+ extension for new development, as it was deprecated in PHP 5.5.0 and was
+ removed in PHP 7. 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>
@@ -233,16 +241,22 @@
<entry>Yes</entry>
</row>
<row>
+ <entry>Included with PHP 7.x</entry>
+ <entry>Yes</entry>
+ <entry>Yes</entry>
+ <entry>No</entry>
+ </row>
+ <row>
<entry>Development status</entry>
<entry>Active</entry>
<entry>Active</entry>
- <entry>Maintenance only</entry>
+ <entry>Maintenance only in 5.x; removed in 7.x</entry>
</row>
<row>
<entry>Lifecycle</entry>
<entry>Active</entry>
<entry>Active</entry>
- <entry>Deprecated</entry>
+ <entry>Deprecated in 5.x; removed in 7.x</entry>
</row>
<row>
<entry>Recommended for new projects</entry>