cvs: phpdoc-ja /reference/apc .cvsignore ini.xml reference.xml /reference/apc/functions apc-cache-info.xml apc-clear-cache.xml
apc-define-constants.xml apc-delete.xml apc-fetch.xml apc-load-constants.xml apc-sma-info.xml apc-store.xml

From: Date: Mon, 15 Aug 2005 09:35:15 +0000
Subject: cvs: phpdoc-ja /reference/apc .cvsignore ini.xml reference.xml /reference/apc/functions apc-cache-info.xml apc-clear-cache.xml
apc-define-constants.xml apc-delete.xml apc-fetch.xml apc-load-constants.xml apc-sma-info.xml apc-store.xml
Groups: php.doc.ja 
Request: Send a blank email to doc-ja+get-1126@lists.php.net to get a copy of this message
takagi Mon Aug 15 05:35:15 2005 EDT Added files: /phpdoc-ja/reference/apc/functions apc-store.xml apc-sma-info.xml apc-load-constants.xml apc-fetch.xml apc-delete.xml apc-define-constants.xml apc-clear-cache.xml apc-cache-info.xml /phpdoc-ja/reference/apc reference.xml ini.xml .cvsignore Log: added japanese manual.

http://cvs.php.net/co.php/phpdoc-ja/reference/apc/functions/apc-store.xml?r=1.1&p=1 Index: phpdoc-ja/reference/apc/functions/apc-store.xml +++ phpdoc-ja/reference/apc/functions/apc-store.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: takagi Status: ready --> <refentry id="function.apc-store"> <refnamediv> <refname>apc_store</refname> <refpurpose> 変数をデータ領域にキャッシュする </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>apc_store</methodname> <methodparam><type>string</type><parameter>key</parameter></methodparam> <methodparam><type>mixed</type><parameter>var</parameter></methodparam> <methodparam><type>int</type><parameter>ttl</parameter></methodparam> </methodsynopsis> <note> <simpara> PHP の他の多くの仕組みと異なり、<function>apc_store</function> を用いて格納された変数はリクエストを超えて (その値がキャッシュから取り除かれるまで)持続します。 </simpara> </note> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>key</parameter></term> <listitem> <para> この名前を用いて変数を格納します。<parameter>key</parameter> は キャッシュ内で一意です。そのため、同一の <parameter>key</parameter> で新しい値を格納すると、元の値は上書きされます。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>var</parameter></term> <listitem> <para> 格納する変数。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>ttl</parameter></term> <listitem> <para> 有効期間。<parameter>var</parameter> は、キャッシュに <parameter>ttl</parameter> 秒間だけ格納されます。 <parameter>ttl</parameter> が経過すると、格納されている変数は (次のリクエスト時に)キャッシュから削除されます。 <parameter>ttl</parameter> が指定されていない(あるいは <parameter>ttl</parameter> が <literal>0</literal> の場合)は、 キャッシュから手動で削除される・あるいはキャッシュに存在できなくなる (clear, restart など)まで値が持続します。 </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title>A <function>apc_store</function> の例</title> <programlisting role="php"> <![CDATA[ <?php $bar = 'BAR'; apc_store('foo', $bar); var_dump(apc_fetch('foo')); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ string(3) "BAR" ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>apc_fetch</function></member> <member><function>apc_delete</function></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ja/reference/apc/functions/apc-sma-info.xml?r=1.1&p=1 Index: phpdoc-ja/reference/apc/functions/apc-sma-info.xml +++ phpdoc-ja/reference/apc/functions/apc-sma-info.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: takagi Status: ready --> <refentry id="function.apc-sma-info"> <refnamediv> <refname>apc_sma_info</refname> <refpurpose> APC の共有メモリ割り当てに関する情報を取得する </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>array</type><methodname>apc_sma_info</methodname> <void/> </methodsynopsis> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> 共有メモリ割り当てデータの配列を返します。失敗した場合は &false; を返します。 </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>apc_sma_info</function> の例</title> <programlisting role="php"> <![CDATA[ <?php print_r(apc_sma_info()); ?> ]]> </programlisting> &example.outputs.similar; <screen> <![CDATA[ Array ( [num_seg] => 1 [seg_size] => 31457280 [avail_mem] => 31448408 [block_lists] => Array ( [0] => Array ( [0] => Array ( [size] => 31448408 [offset] => 8864 ) ) ) ) ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member> <link linkend="apc.configuration">APC 設定ディレクティブ</link> </member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ja/reference/apc/functions/apc-load-constants.xml?r=1.1&p=1 Index: phpdoc-ja/reference/apc/functions/apc-load-constants.xml +++ phpdoc-ja/reference/apc/functions/apc-load-constants.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: takagi Status: ready --> <refentry id="function.apc-load-constants"> <refnamediv> <refname>apc_load_constants</refname> <refpurpose> 定数群をキャッシュから読み込む </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>mixed</type><methodname>apc_load_constants</methodname> <methodparam><type>string</type><parameter>key</parameter></methodparam> <methodparam choice="opt"><type>bool</type><parameter>case_sensitive</parameter></methodparam> </methodsynopsis> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>key</parameter></term> <listitem> <para> 取得したい定数群(<function>apc_define_constants</function> を使用して格納されたもの)。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>case_sensitive</parameter></term> <listitem> <para> デフォルトでは、定数名の大文字・小文字は区別されます。すなわち、 <literal>CONSTANT</literal> と <literal>Constant</literal> は別の値を表します。このパラメータを &false; にすると、 定数名の大文字・小文字は区別されなくなります。 </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>apc_load_constants</function> の例</title> <programlisting role="php"> <![CDATA[ <?php $constants = array( 'ONE' => 1, 'TWO' => 2, 'THREE' => 3, ); apc_define_constants('numbers', $constants); apc_load_constants('numbers'); echo ONE, TWO, THREE; ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ 123 ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>apc_define_constants</function></member> <member><function>define</function></member> <member><function>constant</function></member> <member> あるいは <link linkend="language.constants">PHP リファレンスの「定数」</link> </member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ja/reference/apc/functions/apc-fetch.xml?r=1.1&p=1 Index: phpdoc-ja/reference/apc/functions/apc-fetch.xml +++ phpdoc-ja/reference/apc/functions/apc-fetch.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: takagi Status: ready --> <refentry id="function.apc-fetch"> <refnamediv> <refname>apc_fetch</refname> <refpurpose> 格納されている変数をキャッシュから取得する </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>mixed</type><methodname>apc_fetch</methodname> <methodparam><type>string</type><parameter>key</parameter></methodparam> </methodsynopsis> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>key</parameter></term> <listitem> <para> (<function>apc_store</function> を用いて)値を格納する際に 使用された <parameter>key</parameter> 。 </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> 成功した場合に格納されていた変数、失敗した場合に &false; を返します。 </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>apc_fetch</function> の例</title> <programlisting role="php"> <![CDATA[ <?php $bar = 'BAR'; apc_store('foo', $bar); var_dump(apc_fetch('foo')); ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ string(3) "BAR" ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>apc_store</function></member> <member><function>apc_delete</function></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ja/reference/apc/functions/apc-delete.xml?r=1.1&p=1 Index: phpdoc-ja/reference/apc/functions/apc-delete.xml +++ phpdoc-ja/reference/apc/functions/apc-delete.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: takagi Status: ready --> <refentry id="function.apc-delete"> <refnamediv> <refname>apc_delete</refname> <refpurpose> 格納されている変数をキャッシュから取り除く </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>apc_delete</methodname> <methodparam><type>string</type><parameter>key</parameter></methodparam> </methodsynopsis> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>key</parameter></term> <listitem> <para> (<function>apc_store</function> を用いて)値を格納する際に 使用された <parameter>key</parameter> 。 </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>apc_delete</function> の例</title> <programlisting role="php"> <![CDATA[ <?php $bar = 'BAR'; apc_store('foo', $bar); apc_delete('foo')); // もちろん、このような使い方は無意味 ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>apc_store</function></member> <member><function>apc_fetch</function></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ja/reference/apc/functions/apc-define-constants.xml?r=1.1&p=1 Index: phpdoc-ja/reference/apc/functions/apc-define-constants.xml +++ phpdoc-ja/reference/apc/functions/apc-define-constants.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: takagi Status: ready --> <refentry id="function.apc-define-constants"> <refnamediv> <refname>apc_define_constants</refname> <refpurpose> 後で利用するため、そして大量の定義を一括して行うために 複数の定数を一括定義する </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>mixed</type><methodname>apc_define_constants</methodname> <methodparam><type>string</type><parameter>key</parameter></methodparam> <methodparam><type>array</type><parameter>constants</parameter></methodparam> <methodparam choice="opt"><type>bool</type><parameter>case_sensitive</parameter></methodparam> </methodsynopsis> <para> ご存知のとおり、<function>define</function> は非常に遅いです。APC を使用する 主な利点はスクリプト/アプリケーションのパフォーマンスの改善なので、大量の 定数を定義する手順を合理化するために、この仕組みが提供されています。 </para> <note> <simpara> (キャッシュ全体をクリアすることなく)格納されている定数を削除するには、 <parameter>constants</parameter> に空の配列を渡します。そうすれば、 そこに格納されていた値は事実上削除されます。 </simpara> </note> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>key</parameter></term> <listitem> <para> <parameter>key</parameter> は、格納される定数群の名前を表します。 この <parameter>key</parameter> は、格納されている定数を <function>apc_load_constants</function> で取得するために使用されます。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>constants</parameter></term> <listitem> <para> <literal>constant_name => value</literal> 形式の連想配列。 <literal>constant_name</literal> は、一般の <link linkend="language.constants">定数</link> の命名規則に従う 必要があります。 <literal>value</literal> は、スカラ値でなければ なりません。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>case_sensitive</parameter></term> <listitem> <para> デフォルトでは、定数名の大文字・小文字は区別されます。すなわち、 <literal>CONSTANT</literal> と <literal>Constant</literal> は別の値を表します。このパラメータを &false; にすると、 定数名の大文字・小文字は区別されなくなります。 </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> &return.success; </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>apc_define_constants</function> の例</title> <programlisting role="php"> <![CDATA[ <?php $constants = array( 'ONE' => 1, 'TWO' => 2, 'THREE' => 3, ); apc_define_constants('numbers', $constants); apc_load_constants('numbers'); echo ONE, TWO, THREE; ?> ]]> </programlisting> &example.outputs; <screen> <![CDATA[ 123 ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>apc_load_constants</function></member> <member><function>define</function></member> <member><function>constant</function></member> <member> あるいは <link linkend="language.constants">PHP リファレンスの「定数」</link> </member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ja/reference/apc/functions/apc-clear-cache.xml?r=1.1&p=1 Index: phpdoc-ja/reference/apc/functions/apc-clear-cache.xml +++ phpdoc-ja/reference/apc/functions/apc-clear-cache.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: takagi Status: ready --> <refentry id="function.apc-clear-cache"> <refnamediv> <refname>apc_clear_cache</refname> <refpurpose> APC キャッシュをクリアする </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>apc_clear_cache</methodname> <void/> </methodsynopsis> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ja/reference/apc/functions/apc-cache-info.xml?r=1.1&p=1 Index: phpdoc-ja/reference/apc/functions/apc-cache-info.xml +++ phpdoc-ja/reference/apc/functions/apc-cache-info.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: takagi Status: ready --> <refentry id="function.apc-cache-info"> <refnamediv> <refname>apc_cache_info</refname> <refpurpose> APC のデータから、キャッシュされた情報(およびメタデータ)を取得する </refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>array</type><methodname>apc_cache_info</methodname> <void/> </methodsynopsis> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> キャッシュされたデータ(およびメタデータ)の配列を返します。 失敗した場合には &false; を返します。 </para> <note> <simpara> もし APC キャッシュのデータを取得できなかった場合、 <function>apc_cache_info</function> は警告を発生します。これが起こるのは、 一般的には APC が有効になっていない場合などです。 </simpara> </note> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>apc_cache_info</function> の例</title> <programlisting role="php"> <![CDATA[ <?php print_r(apc_cache_info()); ?> ]]> </programlisting> &example.outputs.similar; <screen> <![CDATA[ Array ( [num_slots] => 2000 [ttl] => 0 [num_hits] => 9 [num_misses] => 3 [start_time] => 1123958803 [cache_list] => Array ( [0] => Array ( [filename] => /path/to/apc_test.php [device] => 29954 [inode] => 1130511 [type] => file [num_hits] => 1 [mtime] => 1123960686 [creation_time] => 1123960696 [deletion_time] => 0 [access_time] => 1123962864 [ref_count] => 1 [mem_size] => 677 ) [1] => Array (...iterates for each cached file) ) ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><link linkend="apc.configuration">APC 設定ディレクティブ</link></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ja/reference/apc/reference.xml?r=1.1&p=1 Index: phpdoc-ja/reference/apc/reference.xml +++ phpdoc-ja/reference/apc/reference.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: takagi Status: ready --> <reference id="ref.apc"> <title>Alternative PHP Cache (APC)</title> <titleabbrev>APC</titleabbrev> <partintro> <section id="apc.intro"> &reftitle.intro; <para> Alternative PHP Cache (APC) は、PHP の実行コードをキャッシュする仕組みで、 フリーかつオープンに使用できます。PHP の中間コードのキャッシュ・最適化を 行うためのフリーでオープン、かつ堅牢なフレームワークを提供するという 考えのもとに作られています。 </para> </section> <section id="apc.installation"> &reftitle.install; <para> &pecl.moved; </para> <para> &pecl.info; <ulink url="&url.pecl.package;apc">&url.pecl.package;apc</ulink>. </para> <para> &pecl.windows.download; </para> <note> <simpara> Windows 版の APC では、<literal>c:\tmp</literal> が存在し、 Web サーバがそのフォルダへの書き込み権限を有することを想定しています。 </simpara> </note> <note> <simpara> さらに深く踏み込んだ高度な技術情報は、 <ulink url="&url.apc.technotes;"> developer-supplied TECHNOTES file </ulink> を参照ください。 </simpara> </note> </section> &reference.apc.ini; <section id="apc.resources"> &reftitle.resources; &no.resource; </section> <section id="apc.constants"> &reftitle.constants; &no.constants; </section> </partintro> &reference.apc.functions; </reference> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ja/reference/apc/ini.xml?r=1.1&p=1 Index: phpdoc-ja/reference/apc/ini.xml +++ phpdoc-ja/reference/apc/ini.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: takagi Status: ready --> <section id="apc.configuration"> &reftitle.runtime; &extension.runtime; <para> たいていの場合はデフォルトの APC 設定でうまく動作しますが、 きちんとチューニングをしたい場合は以下のパラメータを設定します。 </para> <para> <table> <title>APC の設定オプション</title> <tgroup cols="4"> <thead> <row> <entry>名前</entry> <entry>デフォルト</entry> <entry>変更の可否</entry> <entry>変更履歴</entry> </row> </thead> <tbody> <row> <entry>apc.enabled</entry> <entry>1</entry> <entry>PHP_INI_ALL</entry> <entry></entry> </row> <row> <entry>apc.shm_segments</entry> <entry>1</entry> <entry>PHP_INI_SYSTEM</entry> <entry></entry> </row> <row> <entry>apc.shm_size</entry> <entry>30</entry> <entry>PHP_INI_SYSTEM</entry> <entry></entry> </row> <row> <entry>apc.optimization</entry> <entry>0</entry> <entry>PHP_INI_ALL</entry> <entry></entry> </row> <row> <entry>apc.num_files_hint</entry> <entry>1000</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.gc_ttl</entry> <entry>3600</entry> <entry>PHP_INI_SYSTEM</entry> <entry></entry> </row> <row> <entry>apc.cache_by_default</entry> <entry>On</entry> <entry>PHP_INI_SYSTEM</entry> <entry></entry> </row> <row> <entry>apc.filters</entry> <entry>""</entry> <entry>PHP_INI_SYSTEM</entry> <entry></entry> </row> <row> <entry>apc.mmap_file_mask</entry> <entry>""</entry> <entry>PHP_INI_SYSTEM</entry> <entry></entry> </row> <row> <entry>apc.slam_defense</entry> <entry>0</entry> <entry>PHP_INI_SYSTEM</entry> <entry></entry> </row> <row> <entry>apc.file_update_protection</entry> <entry>2</entry> <entry>PHP_INI_SYSTEM</entry> <entry></entry> </row> <row> <entry>apc.enable_cli</entry> <entry>0</entry> <entry>PHP_INI_SYSTEM</entry> <entry>&gt; APC 3.0.6</entry> </row> </tbody> </tgroup> </table> &ini.php.constants; </para> &ini.descriptions.title; <para> <variablelist> <varlistentry id="ini.apc.enabled"> <term> <parameter>apc.enabled</parameter> <type>boolean</type> </term> <listitem> <para> <literal>apc.enabled</literal> を 0 にすることで APC を無効にできます。 APC が静的にコンパイルされて PHP に組み込まれており、他に無効にする 手段がない場合などに有用です(DSO としてコンパイルされている場合は、 単に <literal>zend_extension</literal> の行をコメントアウトするだけで 無効にできます)。 </para> </listitem> </varlistentry> <varlistentry id="ini.apc.shm-segments"> <term> <parameter>apc.shm_segments</parameter> <type>integer</type> </term> <listitem> <para> コンパイラキャッシュのために割り当てる共有メモリセグメントの数。 APC が割り当て済みの共有メモリを使い切ってしまっているが すでにシステムが許す限り <literal>apc.shm_size</literal> を拡大している といった場合に、この値を大きくすることを試みます。 </para> </listitem> </varlistentry> <varlistentry id="ini.apc.shm-size"> <term> <parameter>apc.shm_size</parameter> <type>integer</type> </term> <listitem> <para> 個々の共有メモリセグメントの大きさを MB 単位で指定します。 デフォルトで、共有メモリセグメントの大きさが非常に小さく設定されている システムもあります(大半の BSD 系システムがこれに含まれます)。 </para> </listitem> </varlistentry> <varlistentry id="ini.apc.optimization"> <term> <parameter>apc.optimization</parameter> <type>integer</type> </term> <listitem> <para> 最適化レベル。ゼロは最適化を無効にし、値を大きくするほど 最適化のレベルが高くなります。わずかながら速度の向上が 期待できます。この項目は実験的なものです。 </para> </listitem> </varlistentry> <varlistentry id="ini.apc.num-files-hint"> <term> <parameter>apc.num_files_hint</parameter> <type>integer</type> </term> <listitem> <para> Web サーバで読み込まれるソースファイルの総数についての 「ヒント」。よくわからない場合はゼロを指定するか、単に 無視してください。何千ものソースファイルを扱っているような サイトで有用です。 </para> </listitem> </varlistentry> <varlistentry id="ini.apc.ttl"> <term> <parameter>apc.ttl</parameter> <type>integer</type> </term> <listitem> <para> キャッシュされているエントリが、他のエントリに割り当てられるまで スロットに残っていることの可能な秒数。ゼロのままにしておくと、 キャッシュの中身が古いエントリでいっぱいになってしまい、 新しいエントリがキャッシュできなくなります。 </para> </listitem> </varlistentry> <varlistentry id="ini.apc.gc-ttl"> <term> <parameter>apc.gc_ttl</parameter> <type>integer</type> </term> <listitem> <para> キャッシュエントリがガベージコレクションのリストに残り続ける秒数。 ソースファイルのキャッシュ中にサーバプロセスが死んだ場合の安全装置と なります。ソースファイルが変更された場合、メモリに割り当てられている 古いバージョンはこの TTL に達するまで再読み込みされません。 この機能を無効にするには、ゼロを設定します。 </para> </listitem> </varlistentry> <varlistentry id="ini.apc.cache-by-default"> <term> <parameter>apc.cache_by_default</parameter> <type>boolean</type> </term> <listitem> <para> デフォルトで On です。しかし、これを Off にして <literal>+</literal> で始まる <literal>apc.filters</literal> とともに使用することで、フィルタに一致したファイルのみを キャッシュすることが可能です。 </para> </listitem> </varlistentry> <varlistentry id="ini.apc.filters"> <term> <parameter>apc.filters</parameter> <type>string</type> </term> <listitem> <para> カンマで区切られた、POSIX 拡張正規表現のリスト。ソースファイル名が いずれかのパターンにマッチした場合、そのファイルはキャッシュされません。 マッチングに使用されるファイル名は include/require に渡される名前であり、 絶対パスではないことに注意しましょう。正規表現が <literal>+</literal> で 始まっている場合、その条件にマッチするファイルはキャッシュされます。 また <literal>-</literal> で始まっている場合は、条件にマッチするファイルは キャッシュされません。デフォルトは <literal>-</literal> なので、これは 省略可能です。 </para> </listitem> </varlistentry> <varlistentry id="ini.apc.mmap-file-mask"> <term> <parameter>apc.mmap_file_mask</parameter> <type>string</type> </term> <listitem> <para> <literal>--enable-mmap</literal> を用いて MMAP サポートつきで コンパイルされている場合、ここで mktemp 形式のファイルマスクを 指定します。mmap モジュールは、mmap されたメモリ領域をファイルに 置くか共有メモリに置くかを、これによって判断します。 ファイルベースの mmap を使用するには、この値を <literal>/tmp/apc.XXXXXX</literal> (正確に 6 つの <literal>X</literal>)のように指定します。 POSIX 形式の shm_open/mmap を使用するには、<literal>.shm</literal> をマスクのどこかで指定します。例: <literal>/apc.shm.XXXXXX</literal> 。 また、<literal>/dev/zero</literal> を指定することで、カーネルの <literal>/dev/zero</literal> インターフェースを使用した anonymous mmap を使用することもできます。未定義の場合は、この方式が用いられます。 </para> </listitem> </varlistentry> <varlistentry id="ini.apc.slam-defense"> <term> <parameter>apc.slam_defense</parameter> <type>integer</type> </term> <listitem> <para> 非常にアクセスの多いサーバでは、サーバを起動したりファイルを書き換えたり するたびに「多くのプロセスが」「同時に」「同じファイルを」キャッシュ しようとすることになります。このオプションを指定すると、ある一定の パーセンテージでファイルをキャッシュせずに利用するようにします。 あるいは、単一のプロセスがキャッシュ処理をスキップする確率と 考えることもできます。 たとえば、<literal>apc.slam_defense</literal> を <literal>75</literal> に設定すると、プロセスがキャッシュされていないファイルをキャッシュする 処理を 75% の確率で抑えられます。つまり、この値を大きく設定することで キャッシュ処理の混雑を防ぐことが可能です。値を <literal>0</literal> に設定すると、この機能が無効になります。 </para> </listitem> </varlistentry> <varlistentry id="ini.apc.file-update-protection"> <term> <parameter>apc.file_update_protection</parameter> <type>integer</type> </term> <listitem> <para> 稼動中の Web サーバ上のファイルを書き換える場合、それを原始的(atomic) な手段で行うべきです。つまり、まずいったん一時ファイルに書き込み、 準備ができた時点でそれをリネーム(<literal>mv</literal>)して 正しい位置に移動します。多くのテキストエディタや cp、tar その他の プログラムはこの方式ではありません。ということは、ファイルの書き込み中に そのファイルがアクセスされる(そしてキャッシュされる)可能性がある わけです。<literal>apc.file_update_protection</literal> は、 新しいファイルをキャッシュするまでの遅延を設定します。デフォルトは 2 秒で、ファイルの更新時刻(<literal>mtime</literal>)がアクセス時刻と 2 秒未満しか違わない場合はファイルをキャッシュしないという意味です。 更新の最中のファイルにアクセスしてしまった不幸な人には変なデータが 見えてしまいますが、少なくともその変な状態がキャッシュされてしまう ことはありません。rsync などの原始的な更新を保証する方式を利用する ことがわかっている場合は、値を 0 に設定することでこの機能を無効に できます。更新処理に 2 秒以上かかるようなシステムを利用している 場合は、この値をもう少し大きくしたくなるかもしれません。 </para> </listitem> </varlistentry> <varlistentry id="ini.apc.enable-cli"> <term> <parameter>apc.enable-cli</parameter> <type>integer</type> </term> <listitem> <para> たいていは、テストやデバッグ用に使用します。これを設定すると CLI バージョンの PHP で APC を有効にします。通常は、すべての CLI リクエストに対して APC キャッシュを作成/格納/削除したいとは 思わないでしょう。しかし、CLI バージョンの APC を簡単に作成できるように しておくことは、多くのテストシナリオで有用です。 </para> </listitem> </varlistentry> </variablelist> </para> </section> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/co.php/phpdoc-ja/reference/apc/.cvsignore?r=1.1&p=1 Index: phpdoc-ja/reference/apc/.cvsignore +++ phpdoc-ja/reference/apc/.cvsignore functions.xml
« previous php.doc.ja (#1126) next »