svn: /phpdoc/en/trunk/reference/mysqlnd_qc/ changes.xml ini.xml quickstart.xml

uw Tue, 24 Jan 2012 16:35:42 +0000 Revision: http://svn.php.net/viewvc?view=revision&revision=322684 Log: Document PHP directive for writing cache stats to a log Changed paths: U phpdoc/en/trunk/reference/mysqlnd_qc/changes.xml U phpdoc/en/trunk/reference/mysqlnd_qc/ini.xml U phpdoc/en/trunk/reference/mysqlnd_qc/quickstart.xml Modified: phpdoc/en/trunk/reference/mysqlnd_qc/changes.xml =================================================================== --- phpdoc/en/trunk/reference/mysqlnd_qc/changes.xml 2012-01-24 16:34:18 UTC (rev 322683) +++ phpdoc/en/trunk/reference/mysqlnd_qc/changes.xml 2012-01-24 16:35:42 UTC (rev 322684) @@ -29,6 +29,42 @@ </listitem> </itemizedlist> </para> + <para> + Feature changes + <itemizedlist> + <listitem> + <para> + APC storage handler update + <itemizedlist> + <listitem> + <simpara> + Fix build for APC 3.1.9+ + </simpara> + </listitem> + <listitem> + <simpara> + Note: Use of the APC storage handler is currently + not recommended due to stability issues of APC itself. + </simpara> + </listitem> + </itemizedlist> + </para> + </listitem> + <listitem> + <para> + New PHP configuration directive + <itemizedlist> + <listitem> + <simpara> + <literal><link linkend="ini.mysqlnd-qc.collect-statistics-log-file"> + mysqlnd_qc.collect_statistics_log_file</link></literal> + </simpara> + </listitem> + </itemizedlist> + </para> + </listitem> + </itemizedlist> + </para> </section> <section xml:id="mysqlnd-qc.changes-one-o"> Modified: phpdoc/en/trunk/reference/mysqlnd_qc/ini.xml =================================================================== --- phpdoc/en/trunk/reference/mysqlnd_qc/ini.xml 2012-01-24 16:34:18 UTC (rev 322683) +++ phpdoc/en/trunk/reference/mysqlnd_qc/ini.xml 2012-01-24 16:35:42 UTC (rev 322684) @@ -67,6 +67,13 @@ </entry> </row> <row> + <entry><link linkend="ini.mysqlnd-qc.collect-statistics-log-file">mysqlnd_qc.collect_statistics_log_file</link></entry> + <entry>/tmp/mysqlnd_qc.stats</entry> + <entry>PHP_INI_SYSTEM</entry> + <entry><!-- leave empty, this will be filled by an automatic script --> + </entry> + </row> + <row> <entry><link linkend="ini.mysqlnd-qc.collect-query-trace">mysqlnd_qc.collect_query_trace</link></entry> <entry>0</entry> <entry>PHP_INI_SYSTEM</entry> @@ -246,6 +253,24 @@ </para> </listitem> </varlistentry> + <varlistentry xml:id="ini.mysqlnd-qc.collect-statistics-log-file"> + <term> + <parameter>mysqlnd_qc.collect_statistics-log-file</parameter> + <type>integer</type> + </term> + <listitem> + <para> + If <literal>mysqlnd_qc.collect_statistics</literal> and + <literal>mysqlnd_qc.collect_statistics_log_file</literal> + are set, the plugin will dump statistics into the specified + log file at every 10th web request during PHP request shutdown. + The log file needs to be writeable by the web server user. + </para> + <para> + Since 1.1.0. + </para> + </listitem> + </varlistentry> <varlistentry xml:id="ini.mysqlnd-qc.collect-query-trace"> <term> <parameter>mysqlnd_qc.collect_query_trace</parameter> Modified: phpdoc/en/trunk/reference/mysqlnd_qc/quickstart.xml =================================================================== --- phpdoc/en/trunk/reference/mysqlnd_qc/quickstart.xml 2012-01-24 16:34:18 UTC (rev 322683) +++ phpdoc/en/trunk/reference/mysqlnd_qc/quickstart.xml 2012-01-24 16:35:42 UTC (rev 322684) @@ -1414,6 +1414,11 @@ scripts can be found which give an example how to write a cache monitor. Please, follow the instructions given in the source. </para> + <para> + Since PECL/mysqlnd_qc 1.1.0 it is possible to write statistics into a + log file. Please, see <literal><link linkend="ini.mysqlnd-qc.collect-statistics-log-file"> + mysqlnd_qc.collect_statistics_log_file</link></literal>. + </para> </section> <section xml:id="mysqlnd-qc.set-user-handlers" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">