[prev in list] [next in list] [prev in thread] [next in thread]
List: php-doc-cvs
Subject: [DOC-CVS] =?utf-8?q?svn:_/phpdoc/en/trunk/reference/mysqlnd=5Fmux/_book.xml_concepts.xml_configure.x
From: Philip_Olson <philip () php ! net>
Date: 2012-08-28 21:08:43
Message-ID: svn-philip-1346188123-327346-1329483526 () svn ! php ! net
[Download RAW message or body]
philip Tue, 28 Aug 2012 21:08:43 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=327346
Log:
Misc changes
Changed paths:
U phpdoc/en/trunk/reference/mysqlnd_mux/book.xml
U phpdoc/en/trunk/reference/mysqlnd_mux/concepts.xml
U phpdoc/en/trunk/reference/mysqlnd_mux/configure.xml
["svn-diffs-327346.txt" (text/x-diff)]
Modified: phpdoc/en/trunk/reference/mysqlnd_mux/book.xml
===================================================================
--- phpdoc/en/trunk/reference/mysqlnd_mux/book.xml 2012-08-28 19:12:07 UTC (rev 327345)
+++ phpdoc/en/trunk/reference/mysqlnd_mux/book.xml 2012-08-28 21:08:43 UTC (rev 327346)
@@ -9,25 +9,17 @@
&reftitle.intro;
<para>
The mysqlnd multiplexing plugin (<literal>mysqlnd_mux</literal>)
- multiplexes MySQL connections established by all PHP MySQL extensions that use
- <link linkend="book.mysqlnd">mysqlnd</link>.
+ multiplexes MySQL connections established by all PHP MySQL extensions
+ that use the MySQL native driver (<link linkend="book.mysqlnd">mysqlnd</link>)
+ for PHP.
</para>
<para>
- As of version PHP 5.3.3 the MySQL native driver for PHP
- (<literal>mysqlnd</literal>)
- features an internal plugin C API. C plugins, such as the
- connection multiplexing plugin, can extend the functionality of
- <link linkend="book.mysqlnd">mysqlnd</link>.
+ The MySQL native driver for PHP features an internal C API for plugins,
+ such as the connection multiplexing plugin, which can extend the functionality of
+ mysqlnd. See the <link linkend="book.mysqlnd">mysqlnd</link> for additional details
+ about its benefits over the MySQL Client Library libmysql/libmysqlclient.
</para>
<para>
- The MySQL native driver for PHP is a C library that ships together with
- PHP as of PHP 5.3.0. It serves as a drop-in replacement for the
- MySQL Client Library (libmysql/libmysqlclient). Using mysqlnd has
- several advantages: no extra downloads are required because it's bundled with PHP,
- it's under the PHP license, there is lower memory consumption in certain cases, and
- it contains new functionality such as asynchronous queries.
- </para>
- <para>
Mysqlnd plugins like <literal>mysqlnd_mux</literal> operate, for the most part,
transparently from a user perspective. The connection multiplexing
plugin supports all PHP applications, and all MySQL PHP extensions.
@@ -47,13 +39,13 @@
<section xml:id="mysqlnd-mux.key-features">
<title>Key Features</title>
<para>
- The key features of PECL/mysqlnd_mux are as follows.
+ The key features of mysqlnd_mux are as follows:
</para>
<para>
<itemizedlist>
<listitem>
<para>
- Transparent and therefore easy to use.
+ Transparent and therefore easy to use:
</para>
<para>
<itemizedlist>
@@ -64,7 +56,7 @@
</listitem>
<listitem>
<para>
- Little to no application changes required, dependent on the required usage scenario.
+ Little to no application changes are required, dependent on the required usage scenario.
</para>
</listitem>
</itemizedlist>
@@ -73,7 +65,7 @@
<listitem>
<para>
- Reduce server load and connection establishment latency
+ Reduces server load and connection establishment latency:
</para>
<para>
<itemizedlist>
@@ -110,7 +102,7 @@
at the end of the web request, if the PHP deployment model allows.
Thus, subsequently web requests can reuse a
previously opened connection. Like other resources, network
- connections are bound to the scope of a proceess. Thus, they can
+ connections are bound to the scope of a process. Thus, they can
be reused for all web requests served by a process.
</para>
</listitem>
@@ -125,15 +117,15 @@
<section xml:id="mysqlnd-mux.limitations">
<title>Limitations</title>
<para>
- The proof-of-concept does not support unbuffered queries. Prepared
- statements cannot be used. Asynchronous queries are not supported.
+ The proof-of-concept does not support unbuffered queries, prepared
+ statements, and asynchronous queries.
</para>
<para>
- The connection pool is using a combination of transport method and
- hostname as a key. As a consequence two connections to the same
+ The connection pool is using a combination of the transport method and
+ hostname as keys. As a consequence, two connections to the same
host using the same transport method (TCP/IP, Unix socket, Windows named pipe)
will be linked to the same pooled connection even if username and
- password differ. Please, be aware of the possible security implications.
+ password differ. Be aware of the possible security implications.
</para>
<para>
The proof-of-concept is transaction agnostic. It does not about SQL transactions.
@@ -146,7 +138,7 @@
</section>
<section xml:id="mysqlnd-mux.name">
- <title>On the name</title>
+ <title>About the name mysqlnd_mux</title>
<para>
The shortcut <literal>mysqlnd_mux</literal>
stands for <literal>mysqlnd connection multiplexing plugin</literal>.
Modified: phpdoc/en/trunk/reference/mysqlnd_mux/concepts.xml
===================================================================
--- phpdoc/en/trunk/reference/mysqlnd_mux/concepts.xml 2012-08-28 19:12:07 UTC (rev 327345)
+++ phpdoc/en/trunk/reference/mysqlnd_mux/concepts.xml 2012-08-28 21:08:43 UTC (rev 327346)
@@ -5,22 +5,22 @@
<title>Concepts</title>
<para>
This explains the architecture and related concepts for this plugin.
- Reading and understanding these concepts
- is required, in order to use this plugin with success.
+ Reading and understanding these concepts is required to successfully
+ use this plugin.
</para>
+
<section xml:id="mysqlnd-mux.architecture">
<title>Architecture</title>
<para>
- The mysqlnd connection multiplexing plugin is
- implemented as a PHP extension.
+ The mysqlnd connection multiplexing plugin is implemented as a PHP extension.
It is written in C and operates under the hood of PHP. During the
- startup of the PHP interpreter, in the module init phase of the
+ startup of the PHP interpreter, in the module initialization phase of the
PHP engine, it gets registered as a
- <link linkend="book.mysqlnd">mysqlnd</link> plugin to replace selected
+ <link linkend="book.mysqlnd">mysqlnd</link> plugin to replace specific
mysqlnd C methods.
</para>
<para>
- The mysqlnd library is using PHP streams to communicate with the MySQL
+ The mysqlnd library uses PHP streams to communicate with the MySQL
server. PHP streams are accessed by the mysqlnd library through its net module.
The mysqlnd connection multiplexing plugin proxies methods of the mysqlnd
library net module to control opening and closing of network streams.
@@ -30,19 +30,20 @@
functions of either <link linkend="book.mysqli">mysqli</link>,
<link linkend="ref.pdo-mysql">PDO_MYSQL</link> or
<link linkend="book.mysql">ext/mysql</link>, the plugin will search its
- connection pool for an already opened network connection. If the pool
+ connection pool for an open network connection. If the pool
contains a network connection to the host specified by the connect function
using the transport method requested (TCP/IP, Unix domain socket, Windows named pipe),
the pooled connection is linked to the user handle. Otherwise, a new
- network connection is opened, put into the pool and associated with the
+ network connection is opened, put into the poolm and associated with the
user connection handle. This way, multiple user handles can be linked
to the same network connection.
</para>
</section>
+
<section xml:id="mysqlnd-mux.connection_pool">
<title>Connection pool</title>
<para>
- The plugins connection pool is created when PHP intitializes its modules
+ The plugins connection pool is created when PHP initializes its modules
(<literal>MINIT</literal>) and free'd when PHP shuts down the modules
(<literal>MSHUTDOWN</literal>). This is the same as for persistent MySQL connections.
</para>
@@ -61,6 +62,7 @@
is released. An implicit close happens when PHP shuts down its modules.
</para>
</section>
+
<section xml:id="mysqlnd-mux.sharing_connections">
<title>Sharing connections</title>
<para>
Modified: phpdoc/en/trunk/reference/mysqlnd_mux/configure.xml
===================================================================
--- phpdoc/en/trunk/reference/mysqlnd_mux/configure.xml 2012-08-28 19:12:07 UTC (rev 327345)
+++ phpdoc/en/trunk/reference/mysqlnd_mux/configure.xml 2012-08-28 21:08:43 UTC (rev 327346)
@@ -5,18 +5,10 @@
&reftitle.install;
<para>
- &pecl.moved;
- </para>
-
- <para>
&pecl.info;
<link xlink:href="&url.pecl.package;mysqlnd_mux">&url.pecl.package;mysqlnd_mux</link>
</para>
- <para>
- &pecl.windows.download;
- </para>
-
</section>
--
PHP Documentation Commits Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic