New configuration directives

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@234216 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Jakub Vrana 2007-04-21 04:46:03 +00:00
parent 21a4767bf9
commit 13cdb42481

View file

@ -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;
@ -74,12 +74,24 @@
<entry>PHP_INI_SYSTEM</entry>
<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>
@ -134,6 +146,42 @@
<entry>PHP_INI_SYSTEM</entry>
<entry>&gt; APC 3.0.9</entry>
</row>
<row>
<entry>apc.write_lock</entry>
<entry>"1"</entry>
<entry>PHP_INI_SYSTEM</entry>
<entry>&gt;= APC 3.0.11</entry>
</row>
<row>
<entry>apc.report_autofilter</entry>
<entry>"0"</entry>
<entry>PHP_INI_SYSTEM</entry>
<entry>&gt;= APC 3.0.11</entry>
</row>
<row>
<entry>apc.include_once_override</entry>
<entry>"0"</entry>
<entry>PHP_INI_SYSTEM</entry>
<entry>&gt;= APC 3.0.12</entry>
</row>
<row>
<entry>apc.rfc1867</entry>
<entry>"0"</entry>
<entry>PHP_INI_SYSTEM</entry>
<entry>&gt;= APC 3.0.13</entry>
</row>
<row>
<entry>apc.localcache</entry>
<entry>"0"</entry>
<entry>PHP_INI_SYSTEM</entry>
<entry>&gt;= APC 3.0.14</entry>
</row>
<row>
<entry>apc.localcache.size</entry>
<entry>"512"</entry>
<entry>PHP_INI_SYSTEM</entry>
<entry>&gt;= 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>