cvs: phpdoc-ja /reference/apd .cvsignore configure.xml ini.xml reference.xml /reference/apd/functions apd-breakpoint.xml apd-callstack.xml
apd-clunk.xml apd-continue.xml apd-croak.xml apd-dump-function-table.xml apd-dump-persistent-resources.xml apd-dump-regular-resources.xml apd-echo.xml
apd-get-active-symbols.xml apd-set-pprof-trace.xml apd-set-session-trace.xml apd-set-session.xml apd-set-socket-session-trace.xml
override-function.xml rename-function.xml

From: Date: Tue, 16 Aug 2005 21:36:24 +0000
Subject: cvs: phpdoc-ja /reference/apd .cvsignore configure.xml ini.xml reference.xml /reference/apd/functions apd-breakpoint.xml apd-callstack.xml
apd-clunk.xml apd-continue.xml apd-croak.xml apd-dump-function-table.xml apd-dump-persistent-resources.xml apd-dump-regular-resources.xml apd-echo.xml
apd-get-active-symbols.xml apd-set-pprof-trace.xml apd-set-session-trace.xml apd-set-session.xml apd-set-socket-session-trace.xml
override-function.xml rename-function.xml
Groups: php.doc.ja 
Request: Send a blank email to doc-ja+get-1130@lists.php.net to get a copy of this message
takagi Tue Aug 16 17:36:24 2005 EDT Added files: /phpdoc-ja/reference/apd/functions rename-function.xml override-function.xml apd-set-socket-session-trace.xml apd-set-session.xml apd-set-session-trace.xml apd-set-pprof-trace.xml apd-get-active-symbols.xml apd-echo.xml apd-dump-regular-resources.xml apd-dump-persistent-resources.xml apd-dump-function-table.xml apd-croak.xml apd-continue.xml apd-clunk.xml apd-callstack.xml apd-breakpoint.xml /phpdoc-ja/reference/apd reference.xml ini.xml configure.xml .cvsignore Log: added japanese manual.

http://cvs.php.net/co.php/phpdoc-ja/reference/apd/functions/rename-function.xml?r=1.1&p=1 Index: phpdoc-ja/reference/apd/functions/rename-function.xml +++ phpdoc-ja/reference/apd/functions/rename-function.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: takagi Status: ready --> <refentry id="function.rename-function"> <refnamediv> <refname>rename_function</refname> <refpurpose>グローバルの関数テーブルで関数名を変更する</refpurpose> </refnamediv> <refsect1> <title>説明</title> <methodsynopsis> <type>bool</type><methodname>rename_function</methodname> <methodparam><type>string</type><parameter>original_name</parameter></methodparam> <methodparam><type>string</type><parameter>new_name</parameter></methodparam> </methodsynopsis> <para> グローバルの関数テーブルで関数名を変更します。 一時的に組み込み関数を上書きする際に有用です。 </para> <para> <example> <title><function>rename_function</function> の例</title> <programlisting role="php"> <![CDATA[ <?php rename_function('mysql_connect', 'debug_mysql_connect' ); ?> ]]> </programlisting> </example> </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/apd/functions/override-function.xml?r=1.1&p=1 Index: phpdoc-ja/reference/apd/functions/override-function.xml +++ phpdoc-ja/reference/apd/functions/override-function.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: takagi Status: ready --> <refentry id="function.override-function"> <refnamediv> <refname>override_function</refname> <refpurpose>組み込みの関数を上書きする</refpurpose> </refnamediv> <refsect1> <title>説明</title> <methodsynopsis> <type>bool</type><methodname>override_function</methodname> <methodparam><type>string</type><parameter>function_name</parameter></methodparam> <methodparam><type>string</type><parameter>function_args</parameter></methodparam> <methodparam><type>string</type><parameter>function_code</parameter></methodparam> </methodsynopsis> <para> 書式は create_function() と似ています。組み込みの関数を上書きします (シンボルテーブルを書き換えます)。 </para> <para> <example> <title><function>override_function</function> の例</title> <programlisting role="php"> <![CDATA[ <?php override_function('test', '$a,$b', 'echo "DOING TEST"; return $a * $b;'); ?> ]]> </programlisting> </example> </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/apd/functions/apd-set-socket-session-trace.xml?r=1.1&p=1 Index: phpdoc-ja/reference/apd/functions/apd-set-socket-session-trace.xml +++ phpdoc-ja/reference/apd/functions/apd-set-socket-session-trace.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: takagi Status: ready --> <refentry id="function.apd-set-socket-session-trace"> <refnamediv> <refname>apd_set_socket_session_trace</refname> <refpurpose>リモートセッションのデバッグを開始する</refpurpose> </refnamediv> <refsect1> <title>説明</title> <methodsynopsis> <type>bool</type><methodname>apd_set_socket_session_trace</methodname> <methodparam><type>string</type><parameter>ip_address_or_unix_socket_file</parameter></methodparam> <methodparam><type>int</type><parameter>socket_type</parameter></methodparam> <methodparam><type>int</type><parameter>port</parameter></methodparam> <methodparam><type>int</type><parameter>debug_level</parameter></methodparam> </methodsynopsis> <para> IP や(ファイルのような)Unix ドメインソケットで指定される TCP サーバ (例: tcplisten)に接続し、デバッグデータをソケットに送信します。 どのポート番号でも使用可能ですが、小さな番号は他のシステムで 利用されている可能性があるので大きめの番号を推奨します。 </para> <para> socket_type は APD_AF_UNIX(ファイルベースのソケット)あるいは APD_AF_INET (標準 TCP/IP)のいずれかです。 </para> <para> debug_level は以下の整数値を組み合わせた和です。 </para> <para> <programlisting role="script"> <![CDATA[ FUNCTION_TRACE 1 ARGS_TRACE 2 ASSIGNMENT_TRACE 4 STATEMENT_TRACE 8 MEMORY_TRACE 16 TIMING_TRACE 32 SUMMARY_TRACE 64 ]]> </programlisting> </para> <para> この値を「ゼロ」にして開始することは推奨しません。ファイル内の 指定した場所でデバッグを開始するには、ブレークポイントメソッドを 使用します。 </para> <para> <example> <title><function>apd_set_socket_session_trace</function> の例</title> <programlisting role="php"> <![CDATA[ <?php apd_set_socket_session_trace("127.0.0.1",APD_AF_INET,7112,0); ?> ]]> </programlisting> </example> </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/apd/functions/apd-set-session.xml?r=1.1&p=1 Index: phpdoc-ja/reference/apd/functions/apd-set-session.xml +++ phpdoc-ja/reference/apd/functions/apd-set-session.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: takagi Status: ready --> <refentry id="function.apd-set-session"> <refnamediv> <refname>apd_set_session</refname> <refpurpose>カレントのデバッグレベルを変更あるいは設定する</refpurpose> </refnamediv> <refsect1> <title>説明</title> <methodsynopsis> <type>void</type><methodname>apd_set_session</methodname> <methodparam><type>int</type><parameter>debug_level</parameter></methodparam> </methodsynopsis> <para> アプリケーション内で、場所によってデバッグのレベルを増減する際に 使用可能です。debug_level は以下の整数値を組み合わせた和です。 </para> <para> <programlisting role="script"> <![CDATA[ FUNCTION_TRACE 1 ARGS_TRACE 2 ASSIGNMENT_TRACE 4 STATEMENT_TRACE 8 MEMORY_TRACE 16 TIMING_TRACE 32 SUMMARY_TRACE 64 ]]> </programlisting> </para> <para> <example> <title><function>apd_set_session</function> の例</title> <programlisting role="php"> <![CDATA[ <?php apd_set_session(9); ?> ]]> </programlisting> </example> </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/apd/functions/apd-set-session-trace.xml?r=1.1&p=1 Index: phpdoc-ja/reference/apd/functions/apd-set-session-trace.xml +++ phpdoc-ja/reference/apd/functions/apd-set-session-trace.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: takagi Status: ready --> <refentry id="function.apd-set-session-trace"> <refnamediv> <refname>apd_set_session_trace</refname> <refpurpose>セッションのデバッグを開始する</refpurpose> </refnamediv> <refsect1> <title>説明</title> <methodsynopsis> <type>void</type><methodname>apd_set_session_trace</methodname> <methodparam><type>int</type><parameter>debug_level</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>dump_directory</parameter></methodparam> </methodsynopsis> <para> {dump_directory}/apd_dump_{process_id} へのデバッグを開始します。 dump_directory が指定されていない場合は、&php.ini; ファイルの apd.dumpdir 設定が使用されます。 </para> <para> debug_level は以下の整数値を組み合わせた和です。 </para> <para> <programlisting role="script"> <![CDATA[ FUNCTION_TRACE 1 ARGS_TRACE 2 ASSIGNMENT_TRACE 4 STATEMENT_TRACE 8 MEMORY_TRACE 16 TIMING_TRACE 32 SUMMARY_TRACE 64 ]]> </programlisting> </para> <para> MEMORY_TRACE を使用することは推奨しません。これは大変遅いうえに あまり正確ではありません(たいしたものだよ!)。また、ASSIGNMENT_TRACE は実装されていません。したがって、まともに動作するすべての機能 (TIMING, FUNCTIONS, ARGS SUMMARY(strace -c のような))を 使用するには、99 を指定します。 </para> <para> <example> <title><function>apd_set_session_trace</function> の例</title> <programlisting role="php"> <![CDATA[ <?php apd_set_session_trace(99); ?> ]]> </programlisting> </example> </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/apd/functions/apd-set-pprof-trace.xml?r=1.1&p=1 Index: phpdoc-ja/reference/apd/functions/apd-set-pprof-trace.xml +++ phpdoc-ja/reference/apd/functions/apd-set-pprof-trace.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: takagi Status: ready --> <refentry id="function.apd-set-pprof-trace"> <refnamediv> <refname>apd_set_pprof_trace</refname> <refpurpose>セッションのデバッグを開始する</refpurpose> </refnamediv> <refsect1> <title>説明</title> <methodsynopsis> <type>void</type><methodname>apd_set_pprof_trace</methodname> <methodparam choice="opt"><type>string</type><parameter>dump_directory</parameter></methodparam> </methodsynopsis> <para> {dump_directory}/pprof_{process_id} へのデバッグを開始します。 dump_directory が指定されていない場合は、&php.ini; ファイルの apd.dumpdir 設定が使用されます。 </para> <para> <example> <title><function>apd_set_pprof_trace</function> の例</title> <programlisting role="php"> <![CDATA[ <?php apd_set_pprof_trace(); ?> ]]> </programlisting> </example> </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/apd/functions/apd-get-active-symbols.xml?r=1.1&p=1 Index: phpdoc-ja/reference/apd/functions/apd-get-active-symbols.xml +++ phpdoc-ja/reference/apd/functions/apd-get-active-symbols.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: takagi Status: ready --> <refentry id="function.apd-get-active-symbols"> <refnamediv> <refname>apd_get_active_symbols</refname> <refpurpose>ローカルスコープ内のカレントの変数名を配列で取得する</refpurpose> </refnamediv> <refsect1> <title>説明</title> <methodsynopsis> <type>array</type><methodname>apd_get_active_symbols</methodname> <methodparam><parameter/></methodparam> </methodsynopsis> <para> アクティブなスコープ内で定義されているすべての変数名を返します (変数の値ではありません)。 </para> <para> <example> <title><function>apd_get_active_symbols</function> の例</title> <programlisting role="php"> <![CDATA[ <?php apd_echo(apd_get_active_symbols()); ?> ]]> </programlisting> </example> </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/apd/functions/apd-echo.xml?r=1.1&p=1 Index: phpdoc-ja/reference/apd/functions/apd-echo.xml +++ phpdoc-ja/reference/apd/functions/apd-echo.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.5 Maintainer: takagi Status: ready --> <refentry id="function.apd-echo"> <refnamediv> <refname>apd_echo</refname> <refpurpose>デバッグ用ソケットに表示する</refpurpose> </refnamediv> <refsect1> <title>説明</title> <methodsynopsis> <type>bool</type><methodname>apd_echo</methodname> <methodparam><type>string</type><parameter>output</parameter></methodparam> </methodsynopsis> <para> 実行中のスクリプトに関する情報を、一般的にはソケット経由で リクエストします。 </para> <para> <example> <title><function>apd_echo</function> の例</title> <programlisting role="php"> <![CDATA[ <?php apd_echo($i); ?> ]]> </programlisting> </example> </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/apd/functions/apd-dump-regular-resources.xml?r=1.1&p=1 Index: phpdoc-ja/reference/apd/functions/apd-dump-regular-resources.xml +++ phpdoc-ja/reference/apd/functions/apd-dump-regular-resources.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: takagi Status: ready --> <refentry id="function.apd-dump-regular-resources"> <refnamediv> <refname>apd_dump_regular_resources</refname> <refpurpose>カレントのすべての一般リソースを配列で返す</refpurpose> </refnamediv> <refsect1> <title>説明</title> <methodsynopsis> <type>array</type><methodname>apd_dump_regular_resources</methodname> <void/> </methodsynopsis> <para> カレントのすべての一般リソースを配列で返します。 </para> <para> <example> <title><function>apd_dump_regular_resources</function> の例</title> <programlisting role="php"> <![CDATA[ <?php print_r(apd_dump_regular_resources()); ?> ]]> </programlisting> </example> </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/apd/functions/apd-dump-persistent-resources.xml?r=1.1&p=1 Index: phpdoc-ja/reference/apd/functions/apd-dump-persistent-resources.xml +++ phpdoc-ja/reference/apd/functions/apd-dump-persistent-resources.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: takagi Status: ready --> <refentry id="function.apd-dump-persistent-resources"> <refnamediv> <refname>apd_dump_persistent_resources</refname> <refpurpose>すべての持続的なリソースを配列で返す</refpurpose> </refnamediv> <refsect1> <title>説明</title> <methodsynopsis> <type>array</type><methodname>apd_dump_persistent_resources</methodname> <void/> </methodsynopsis> <para> すべての持続的なリソースを配列で返します。 </para> <para> <example> <title><function>apd_dump_persistent_resources</function> の例</title> <programlisting role="php"> <![CDATA[ <?php print_r(apd_dump_persistent_resources()); ?> ]]> </programlisting> </example> </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/apd/functions/apd-dump-function-table.xml?r=1.1&p=1 Index: phpdoc-ja/reference/apd/functions/apd-dump-function-table.xml +++ phpdoc-ja/reference/apd/functions/apd-dump-function-table.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: takagi Status: ready --> <refentry id="function.apd-dump-function-table"> <refnamediv> <refname>apd_dump_function_table</refname> <refpurpose>カレントの関数テーブルを出力する</refpurpose> </refnamediv> <refsect1> <title>説明</title> <methodsynopsis> <type>void</type><methodname>apd_dump_function_table</methodname> <void/> </methodsynopsis> <para> カレントの関数テーブルを出力します。 </para> <para> <example> <title><function>apd_dump_function_table</function> の例</title> <programlisting role="php"> <![CDATA[ <?php apd_dump_function_table(); ?> ]]> </programlisting> </example> </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/apd/functions/apd-croak.xml?r=1.1&p=1 Index: phpdoc-ja/reference/apd/functions/apd-croak.xml +++ phpdoc-ja/reference/apd/functions/apd-croak.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: takagi Status: ready --> <refentry id="function.apd-croak"> <refnamediv> <refname>apd_croak</refname> <refpurpose>エラーとコールスタックをスローし、終了する</refpurpose> </refnamediv> <refsect1> <title>Description</title> <methodsynopsis> <type>void</type><methodname>apd_croak</methodname> <methodparam><type>string</type><parameter>warning</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>delimiter</parameter></methodparam> </methodsynopsis> <para> perl の Carp::croak と同じように動作します。エラーとコールバックを スローし、終了します。デフォルトの行区切り文字は "&lt;BR /&gt;\n" です。 </para> <para> <example> <title><function>apd_croak</function> の例</title> <programlisting role="php"> <![CDATA[ <?php apd_croak("Some Warning","<P>"); ?> ]]> </programlisting> </example> </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/apd/functions/apd-continue.xml?r=1.1&p=1 Index: phpdoc-ja/reference/apd/functions/apd-continue.xml +++ phpdoc-ja/reference/apd/functions/apd-continue.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.6 Maintainer: takagi Status: ready --> <refentry id="function.apd-continue"> <refnamediv> <refname>apd_continue</refname> <refpurpose>インタプリタを再開する</refpurpose> </refnamediv> <refsect1> <title>説明</title> <methodsynopsis> <type>bool</type><methodname>apd_continue</methodname> <methodparam><type>int</type><parameter>debug_level</parameter></methodparam> </methodsynopsis> <para> インタプリタを再開するために、一般的にははソケット経由で送信します。 </para> <para> <example> <title><function>apd_continue</function> の例</title> <programlisting role="php"> <![CDATA[ <?php apd_continue(0); ?> ]]> </programlisting> </example> </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/apd/functions/apd-clunk.xml?r=1.1&p=1 Index: phpdoc-ja/reference/apd/functions/apd-clunk.xml +++ phpdoc-ja/reference/apd/functions/apd-clunk.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: takagi Status: ready --> <refentry id="function.apd-clunk"> <refnamediv> <refname>apd_clunk</refname> <refpurpose>警告とコールスタックをスローする</refpurpose> </refnamediv> <refsect1> <title>説明</title> <methodsynopsis> <type>void</type><methodname>apd_clunk</methodname> <methodparam><type>string</type><parameter>warning</parameter></methodparam> <methodparam choice="opt"><type>string</type><parameter>delimiter</parameter></methodparam> </methodsynopsis> <para> perl の Carp::cluck と同じように動作します。警告とコールバックを スローします。デフォルトの行区切り文字は "&lt;BR /&gt;\n" です。 </para> <para> <example> <title><function>apd_clunk</function> の例</title> <programlisting role="php"> <![CDATA[ <?php apd_clunk("Some Warning","<P>"); ?> ]]> </programlisting> </example> </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/apd/functions/apd-callstack.xml?r=1.1&p=1 Index: phpdoc-ja/reference/apd/functions/apd-callstack.xml +++ phpdoc-ja/reference/apd/functions/apd-callstack.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: takagi Status: ready --> <refentry id="function.apd-callstack"> <refnamediv> <refname>apd_callstack</refname> <refpurpose>カレントのコールスタックを配列で返す</refpurpose> </refnamediv> <refsect1> <title>説明</title> <methodsynopsis> <type>array</type><methodname>apd_callstack</methodname> <void/> </methodsynopsis> <para> カレントのコールスタックを配列形式で返します。 </para> <para> <example> <title><function>apd_callstack</function> の例</title> <programlisting role="php"> <![CDATA[ <?php print_r(apd_callstack()); ?> ]]> </programlisting> </example> </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/apd/functions/apd-breakpoint.xml?r=1.1&p=1 Index: phpdoc-ja/reference/apd/functions/apd-breakpoint.xml +++ phpdoc-ja/reference/apd/functions/apd-breakpoint.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: takagi Status: ready --> <refentry id="function.apd-breakpoint"> <refnamediv> <refname>apd_breakpoint</refname> <refpurpose>インタプリタの処理を停止し、ソケットからの CR を待つ</refpurpose> </refnamediv> <refsect1> <title>説明</title> <methodsynopsis> <type>bool</type><methodname>apd_breakpoint</methodname> <methodparam><type>int</type><parameter>debug_level</parameter></methodparam> </methodsynopsis> <para> スクリプトの実行を停止し、接続しているソケットからの応答を待ち受ける ために使用します。プログラムのステップ実行を行うには、Enter キーを押す (空行を送る)あるいは実行したい PHP コマンドを入力します。tcplisten を用いた典型的なセッションは、このようになります。 </para> <para> <programlisting role="shell"> <![CDATA[ bash#tcplisten localhost 7777 APD - Advanced PHP Debugger Trace File --------------------------------------------------------------------------- Process Pid (6118) Trace Begun at Sun Mar 10 23:13:12 2002 --------------------------------------------------------------------------- ( 0.000000): apd_set_session_trace called at /home/alan/Projects/project2/test. php:5 ( 0.074824): apd_set_session_trace_socket() at /home/alan/Projects/project2/tes t.php:5 returned. Elapsed (0.074824) ( 0.074918): apd_breakpoint() /home/alan/Projects/project2/test.php:7 ++ argv[0] $(??) = 9 apd_breakpoint() at /home/alan/Projects/project2/test.php:7 returned. Elapsed ( -2089521468.1073275368) >\n statement: /home/alan/Projects/project2/test.php:8 >\n statement: /home/alan/Projects/project2/test.php:8 >\n statement: /home/alan/Projects/project2/test.php:10 >apd_echo($i); EXEC: apd_echo($i); 0 >apd_echo(serialize(apd_get_active_symbols())); EXEC: apd_echo(serialize(apd_get_active_symbols())); a:47:{i:0;s:4:"PWD";i:1;s:10:"COLORFGBG";i:2;s:11:"XAUTHORITY";i:3;s:14:" COLORTERM_BCE";i:4;s:9:"WINDOWID";i:5;s:14:"ETERM_VERSION";i:6;s:16:"SE SSION_MANAGER";i:7;s:4:"PS1";i:8;s:11:"GDMSESSION";i:9;s:5:"USER";i:10;s:5:" MAIL";i:11;s:7:"OLDPWD";i:12;s:5:"LANG";i:13;s:10:"COLORTERM";i:14;s:8:"DISP LAY";i:15;s:8:"LOGNAME";i:16;s:6:" >apd_echo(system('ls /home/mydir'));......... >apd_continue(0); ]]> </programlisting> </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/apd/reference.xml?r=1.1&p=1 Index: phpdoc-ja/reference/apd/reference.xml +++ phpdoc-ja/reference/apd/reference.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: takagi Status: ready --> <reference id="ref.apd"> <title>Advanced PHP Debugger (APD)</title> <titleabbrev>APD</titleabbrev> <partintro> <section id="apd.intro"> &reftitle.intro; <para> APD は進化した PHP デバッガです。PHP コードのプロファイリングや デバッグの機能を提供すること、また完全なスタックトレースを出力する 機能を提供することを目的として作成されています。APD は対話形式の デバッグもサポートしていますが、デフォルトではデータをトレース ファイルに書き出すようになっています。また、さまざまなレベルの 情報(関数のコール・渡された引数・時間などを含む)をイベント発生時に 記録することができ、それを個々のスクリプト単位で有効にしたり無効に したりできます。 <caution> <para> APD は Zend 拡張モジュールで、PHP 内部関数のコール方法に手を加えます。 そのため、他の Zend 拡張モジュール(たとえば Zend Optimizer など)との 相性に注意が必要です。 </para> </caution> </para> </section> &reference.apd.configure; &reference.apd.ini; <section id="apd.resources"> &reftitle.resources; &no.resource; </section> <section id="apd.constants"> &reftitle.constants; &no.constants; </section> <section id="apd.examples"> <title>スクリプト中で PHP-APD を使用する方法</title> <procedure> <step> <para> トレースを開始するには、PHP スクリプトの最初の行で apd_set_pprof_trace() 関数をコールします。 </para> <para> <programlisting role="php"> <![CDATA[ apd_set_pprof_trace(); ]]> </programlisting> </para> <para> この行はスクリプト内のどの場所にでも挿入可能ですが、もしスクリプトの 最初からトレースを始めなければ、あなたをパフォーマンスのボトルネックに 導いてくれるかもしれないデータを捨てることになってしまいます。 </para> </step> <step> <para> さあ、スクリプトを実行しましょう。ダンプ結果は <filename>apd.dumpdir/pprof_pid.ext</filename> に出力されます。 <tip> <para> CGI 版の PHP を使用している場合は、apd が正しく動作するように '-e' フラグつきで実行し、拡張情報を有効にしてください。たとえば <userinput>php -e -f script.php</userinput> のように実行します。 </para> </tip> </para> </step> <step> <para> プロファイルデータを整形して表示するには、お好みの並べ替えオプション・ 表示オプションを指定して <command>pprofp</command> コマンドを実行 してください。整形された出力は以下のようになります。 <screen> <![CDATA[ bash-2.05b$ pprofp -R /tmp/pprof.22141.0 Trace for /home/dan/testapd.php Total Elapsed Time = 0.00 Total System Time = 0.00 Total User Time = 0.00 Real User System secs/ cumm %Time (excl/cumm) (excl/cumm) (excl/cumm) Calls call s/call Memory Usage Name -------------------------------------------------------------------------------------- 100.0 0.00 0.00 0.00 0.00 0.00 0.00 1 0.0000 0.0009 0 main 56.9 0.00 0.00 0.00 0.00 0.00 0.00 1 0.0005 0.0005 0 apd_set_pprof_trace 28.0 0.00 0.00 0.00 0.00 0.00 0.00 10 0.0000 0.0000 0 preg_replace 14.3 0.00 0.00 0.00 0.00 0.00 0.00 10 0.0000 0.0000 0 str_replace ]]> </screen> </para> <para> この例で使われている -R オプションは、その関数を実行するのにかかった時間の 順でプロファイルテーブルを並べ替えます。"cumm call" 列には個々の関数が 何回コールされたか、そして "s/call" 列には 1 回のコールあたりの 平均所要時間が表示されます。 </para> </step> <step> <para> KCacheGrind にインポートできる形式のファイルを作成するには、 <command>pprof2calltree</command> コマンドを実行してください。 </para> </step> </procedure> </section> <section id="apd.contact"> <title>連絡先の情報</title> <para> コメント・バグフィックス・機能拡張・あるいは開発を手伝いたいなどの場合は、 メールを <ulink url="mailto:&email.apd;">&email.apd;</ulink> に送ってください。大歓迎します。 </para> </section> </partintro> &reference.apd.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 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/apd/ini.xml?r=1.1&p=1 Index: phpdoc-ja/reference/apd/ini.xml +++ phpdoc-ja/reference/apd/ini.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: takagi Status: ready --> <section id="apd.configuration"> &reftitle.runtime; &extension.runtime; <para> <table> <title>APD の設定オプション</title> <tgroup cols="4"> <thead> <row> <entry>名前</entry> <entry>デフォルト</entry> <entry>変更の可否</entry> <entry>変更履歴</entry> </row> </thead> <tbody> <row> <entry>apd.dumpdir</entry> <entry>NULL</entry> <entry>PHP_INI_ALL</entry> <entry></entry> </row> <row> <entry>apd.statement_tracing</entry> <entry>"0"</entry> <entry>PHP_INI_ALL</entry> <entry></entry> </row> </tbody> </tgroup> </table> &ini.php.constants; </para> &ini.descriptions.title; <para> <variablelist> <varlistentry id="ini.apd.dumpdir"> <term> <parameter>apd.dumpdir</parameter> <type>string</type> </term> <listitem> <para> APD がプロファイルのダンプファイルを書き出すディレクトリを設定します。 絶対パス・相対パスのどちらも指定可能です。 </para> <para> <function>apd_set_pprof_trace</function> へ引数を渡すことで、 指定した以外の場所に書き出すことも可能です。 </para> </listitem> </varlistentry> <varlistentry id="ini.apd.statement-tracing"> <term> <parameter>apd.statement_tracing</parameter> <type>boolean</type> </term> <listitem> <para> 行単位のトレースをするかしないかを設定します。これを on (1) にすると、アプリケーションのパフォーマンスに衝撃的な影響を与えます。 </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/apd/configure.xml?r=1.1&p=1 Index: phpdoc-ja/reference/apd/configure.xml +++ phpdoc-ja/reference/apd/configure.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: takagi Status: ready --> <section id="apd.installation"> &reftitle.install; <para> 現在 APD は PECL 拡張モジュールとして公開されており、 <ulink url="&url.pecl.package;apd">&url.pecl.package;apd</ulink> で入手可能です。CGI 版の PHP がインストールされており、パスの通った場所に phpize スクリプトがあることを確かめてください。 </para> <para> APD の最新安定バージョンをダウンロード・ビルド・インストールするには 以下のコマンドを実行します。 <screen> <![CDATA[ pear install apd ]]> </screen> </para> <para> これは、APD Zend モジュールを自動的に PHP の extension ディレクトリに インストールします。必ずこの場所でなければならないわけではありません。 zend_extension パラメータを適切に設定すれば、PHP が 読み込めるディレクトリならどこにでもインストール可能です。 </para> <para> Windows ユーザは <ulink url="&url.pecl.get.win;">&url.pecl.get.win;</ulink> から <filename>php_apd.dll</filename> をダウンロードできます。 </para> <para> INI ファイルに以下の行を追加します。 </para> <para> <programlisting role="php.ini"> <![CDATA[ zend_extension = /absolute/path/to/apd.so apd.dumpdir = /absolute/path/to/trace/directory apd.statement_tracing = 0 ]]> </programlisting> </para> <para> PHP のビルド状況によって、zend_extension ディレクティブは 以下のうちのいずれかひとつとなります。 </para> <para> <programlisting role="script"> <![CDATA[ zend_extension (非 ZTS, 非 debug ビルド) zend_extension_ts ( ZTS, 非 debug ビルド) zend_extension_debug (非 ZTS, debug ビルド) zend_extension_debug_ts ( ZTS, debug ビルド) ]]> </programlisting> </para> </section> <section id="apd.installwin32"> <title>Win32 でのビルド</title> <para> Windows で APD をビルドするには、http://php.net/ で述べられているような PHP コンパイル環境が必要です。 -- 基本的には、Microsoft Visual C++・ win32build.zip・bison/flex・そしてそれらをうまく動かすためのちょっとした コツが必要になります。また adp.dsp の改行コードは必ず DOS 形式に してください。Unix 形式の改行コードだと、Microsoft Visual C++ に文句を言われます。 </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/apd/.cvsignore?r=1.1&p=1 Index: phpdoc-ja/reference/apd/.cvsignore +++ phpdoc-ja/reference/apd/.cvsignore functions.xml
« previous php.doc.ja (#1130) next »