vrana Sat Apr 21 04:46:03 2007 UTC
Modified files:
/phpdoc/en/reference/apc ini.xml
Log:
New configuration directives
http://cvs.php.net/viewvc.cgi/phpdoc/en/reference/apc/ini.xml?r1=1.8&r2=1.9&diff_format=u
Index: phpdoc/en/reference/apc/ini.xml
diff -u phpdoc/en/reference/apc/ini.xml:1.8 phpdoc/en/reference/apc/ini.xml:1.9
--- phpdoc/en/reference/apc/ini.xml:1.8 Sat Dec 16 20:18:46 2006
+++ phpdoc/en/reference/apc/ini.xml Sat Apr 21 04:46:03 2007
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-1"?>
-<!-- $Revision: 1.8 $ -->
+<!-- $Revision: 1.9 $ -->
<section id="apc.configuration">
&reftitle.runtime;
&extension.runtime;
@@ -75,12 +75,24 @@
<entry></entry>
</row>
<row>
+ <entry>apc.user_entries_hint</entry>
+ <entry>"4096"</entry>
+ <entry>PHP_INI_SYSTEM</entry>
+ <entry></entry>
+ </row>
+ <row>
<entry>apc.ttl</entry>
<entry>"0"</entry>
<entry>PHP_INI_SYSTEM</entry>
<entry></entry>
</row>
<row>
+ <entry>apc.user_ttl</entry>
+ <entry>"0"</entry>
+ <entry>PHP_INI_SYSTEM</entry>
+ <entry></entry>
+ </row>
+ <row>
<entry>apc.gc_ttl</entry>
<entry>"3600"</entry>
<entry>PHP_INI_SYSTEM</entry>
@@ -134,6 +146,42 @@
<entry>PHP_INI_SYSTEM</entry>
<entry>> APC 3.0.9</entry>
</row>
+ <row>
+ <entry>apc.write_lock</entry>
+ <entry>"1"</entry>
+ <entry>PHP_INI_SYSTEM</entry>
+ <entry>>= APC 3.0.11</entry>
+ </row>
+ <row>
+ <entry>apc.report_autofilter</entry>
+ <entry>"0"</entry>
+ <entry>PHP_INI_SYSTEM</entry>
+ <entry>>= APC 3.0.11</entry>
+ </row>
+ <row>
+ <entry>apc.include_once_override</entry>
+ <entry>"0"</entry>
+ <entry>PHP_INI_SYSTEM</entry>
+ <entry>>= APC 3.0.12</entry>
+ </row>
+ <row>
+ <entry>apc.rfc1867</entry>
+ <entry>"0"</entry>
+ <entry>PHP_INI_SYSTEM</entry>
+ <entry>>= APC 3.0.13</entry>
+ </row>
+ <row>
+ <entry>apc.localcache</entry>
+ <entry>"0"</entry>
+ <entry>PHP_INI_SYSTEM</entry>
+ <entry>>= APC 3.0.14</entry>
+ </row>
+ <row>
+ <entry>apc.localcache.size</entry>
+ <entry>"512"</entry>
+ <entry>PHP_INI_SYSTEM</entry>
+ <entry>>= APC 3.0.14</entry>
+ </row>
</tbody>
</tgroup>
</table>
@@ -217,6 +265,19 @@
</para>
</listitem>
</varlistentry>
+ <varlistentry id="ini.apc.user-entries-hint">
+ <term>
+ <parameter>apc.user_entries_hint</parameter>
+ <type>integer</type>
+ </term>
+ <listitem>
+ <para>
+ Just like <link
linkend="ini.apc.num-files-hint">apc.num_files_hint</link>,
+ a "hint" about the number of distinct user cache variables to store.
+ Set to zero or omit if not sure.
+ </para>
+ </listitem>
+ </varlistentry>
<varlistentry id="ini.apc.ttl">
<term>
<parameter>apc.ttl</parameter>
@@ -233,6 +294,20 @@
</para>
</listitem>
</varlistentry>
+ <varlistentry id="ini.apc.user-ttl">
+ <term>
+ <parameter>apc.user_ttl</parameter>
+ <type>integer</type>
+ </term>
+ <listitem>
+ <para>
+ The number of seconds a user cache entry is allowed to idle in a slot in
+ case this cache entry slot is needed by another entry. Leaving this at
+ zero means that your cache could potentially fill up with stale entries
+ while newer entries won't be cached.
+ </para>
+ </listitem>
+ </varlistentry>
<varlistentry id="ini.apc.gc-ttl">
<term>
<parameter>apc.gc_ttl</parameter>
@@ -410,6 +485,99 @@
</para>
</listitem>
</varlistentry>
+
+ <varlistentry id="ini.apc.write-lock">
+ <term>
+ <parameter>apc.write_lock</parameter>
+ <type>boolean</type>
+ </term>
+ <listitem>
+ <para>
+ On busy servers when you first start up the server, or when many files
+ are modified, you can end up with all your processes trying to compile
+ and cache the same files. With write_lock enabled, only one process at a
+ time will try to compile an uncached script while the other processes
+ will run uncached instead of sitting around waiting on a lock.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="ini.apc.report-autofilter">
+ <term>
+ <parameter>apc.report_autofilter</parameter>
+ <type>boolean</type>
+ </term>
+ <listitem>
+ <para>
+ Logs any scripts that were automatically excluded from being cached due
+ to early/late binding issues.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="ini.apc.include-once-override">
+ <term>
+ <parameter>apc.include_once_override</parameter>
+ <type>boolean</type>
+ </term>
+ <listitem>
+ <para>
+ Optimize <function>include_once</function> and
<function>require_once</function>
+ calls and avoid the expensive system calls used.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="ini.apc.rfc1867">
+ <term>
+ <parameter>apc.rfc1867</parameter>
+ <type>boolean</type>
+ </term>
+ <listitem>
+ <para>
+ RFC1867 File Upload Progress hook handler is only available if you
+ compiled APC against PHP 5.2.0 or later. When enabled, any file uploads
+ which includes a field called <literal>APC_UPLOAD_PROGRESS</literal>
+ before the file field in an upload form will cause APC to automatically
+ create an upload_<emphasis>key</emphasis> user cache entry where
+ <emphasis>key</emphasis> is the value of the
+ <literal>APC_UPLOAD_PROGRESS</literal> form entry.
+ </para>
+ <para>
+ Note that the file upload tracking is not threadsafe at this point, so
+ new uploads that happen while a previous one is still going will disable
+ the tracking for the previous.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="ini.apc.localcache">
+ <term>
+ <parameter>apc.localcache</parameter>
+ <type>boolean</type>
+ </term>
+ <listitem>
+ <para>
+ This enables a lock-free local process shadow-cache which reduces lock
+ contention when the cache is being written to.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry id="ini.apc.localcache.size">
+ <term>
+ <parameter>apc.localcache.size</parameter>
+ <type>integer</type>
+ </term>
+ <listitem>
+ <para>
+ The size of the local process shadow-cache, should be set to a
+ sufficently large value, approximately half of
+ <link linkend="ini.apc.num-files-hint">apc.num_files_hint</link>.
+ </para>
+ </listitem>
+ </varlistentry>
+
</variablelist>
</para>
</section>
