cvs: phpdoc-ja /reference/ingres-ii configure.xml constants.xml examples.xml setup.xml

takagi Sun Mar 15 08:03:20 2009 UTC Modified files: /phpdoc-ja/reference/ingres-ii setup.xml examples.xml constants.xml configure.xml Log: sync with en.

http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/ingres-ii/setup.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-ja/reference/ingres-ii/setup.xml diff -u phpdoc-ja/reference/ingres-ii/setup.xml:1.2 phpdoc-ja/reference/ingres-ii/setup.xml:1.3 --- phpdoc-ja/reference/ingres-ii/setup.xml:1.2 Sun Dec 28 01:32:27 2008 +++ phpdoc-ja/reference/ingres-ii/setup.xml Sun Mar 15 08:03:20 2009 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.3 Maintainer: takagi Status: ready --> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.4 Maintainer: takagi Status: ready --> <!-- CREDITS: hirokawa --> <chapter xml:id="ingres.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -10,8 +10,11 @@ <section xml:id="ingres.requirements"> &reftitle.required; <para> - Ingres サポートを有効にして PHP をコンパイルするには、 - Ingres OpenAPI ライブラリとヘッダファイルが必要です。 + Ingres 拡張モジュールを使用したりビルドしたりするには、 + Ingres クライアント環境が動作することが必要となります。Ingres + クライアントソフトウェアは + <link xlink:href="&url.ingres.downloads;">&url.ingres.downloads;</link> + でダウンロードできます。 </para> </section> <!-- }}} --> @@ -31,6 +34,10 @@ <function>ingres_connect</function> および <function>ingres_pconnect</function> は Ingres リンク ID を返します。 </para> + <para> + <function>ingres_query</function> および <function>ingres_unbuffered_query</function> + は Ingres 結果 ID を返します。 + </para> </section> <!-- }}} --> http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/ingres-ii/examples.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-ja/reference/ingres-ii/examples.xml diff -u phpdoc-ja/reference/ingres-ii/examples.xml:1.2 phpdoc-ja/reference/ingres-ii/examples.xml:1.3 --- phpdoc-ja/reference/ingres-ii/examples.xml:1.2 Wed Dec 31 00:58:29 2008 +++ phpdoc-ja/reference/ingres-ii/examples.xml Sun Mar 15 08:03:20 2009 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.3 Maintainer: takagi Status: ready --> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.4 Maintainer: takagi Status: ready --> <!-- CREDITS: hirokawa --> <chapter xml:id="ingres.examples" xmlns="http://docbook.org/ns/docbook"> @@ -15,29 +15,33 @@ <![CDATA[ <?php // 接続し、データベースを選択します -$link = ingres_connect('database', 'user', 'password') - or die('接続できなせんでした: ' . ingres_error($link)); -echo '接続に成功しました'; +$link = ingres_connect("database", "user", "password") + or die("接続できなせんでした: " . ingres_error($link)); +echo "接続に成功しました"; // すべての Ingres データベース内に存在するテーブルから select します -$query = 'SELECT * FROM iirelation'; -$returncode = ingres_query($link,$query) or die('問い合わせに失敗しました: ' . +$query = "SELECT * FROM iitables"; +$result = ingres_query($link,$query) or die("問い合わせに失敗しました: " . ingres_error($link)); // 結果を HTML で出力します // relid - テーブル名 // relowner - テーブルの所有者 echo "<table>\n"; -while ($iirelation = ingres_fetch_object($link)) { +while ($iitables = ingres_fetch_object($result)) { echo "\t<tr>\n"; - echo "\t\t<td>" . $iirelation->relid . "</td>\n"; - echo "\t\t<td>" . $iirelation->relowner . "</td>\n"; + echo "\t\t<td>" . $iitables->relid . "</td>\n"; + echo "\t\t<td>" . $iitables->relowner . "</td>\n"; echo "\t</tr>\n"; } echo "</table>\n"; +// 結果を開放します +ingres_free_result($result); + // トランザクションをコミットします ingres_commit($link); + // 接続を閉じます ingres_close($link); ?> http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/ingres-ii/constants.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-ja/reference/ingres-ii/constants.xml diff -u phpdoc-ja/reference/ingres-ii/constants.xml:1.7 phpdoc-ja/reference/ingres-ii/constants.xml:1.8 --- phpdoc-ja/reference/ingres-ii/constants.xml:1.7 Mon Dec 24 04:07:39 2007 +++ phpdoc-ja/reference/ingres-ii/constants.xml Sun Mar 15 08:03:20 2009 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.12 Maintainer: hirokawa Status: ready --> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.13 Maintainer: hirokawa Status: ready --> <!-- CREDITS: takagi --> <appendix xml:id="ingres.constants" xmlns="http://docbook.org/ns/docbook"> &reftitle.constants; @@ -14,6 +14,7 @@ <listitem> <simpara> フィールド名をキーとする配列でカラムデータを返します。 + <function>ingres_fetch_array</function> で使用します。 </simpara> </listitem> </varlistentry> @@ -25,7 +26,11 @@ <listitem> <simpara> 数値添字の配列でカラムデータを返します。 - 結果の最初のフィールドの添字は 1 となります。 + デフォルトでは、結果の最初のフィールドの添字は 1 となります。 + これを変更するには <link + linkend="ini.ingres.array-index-start">ingres.array_index_start</link> + を参照ください。 + <function>ingres_fetch_array</function> で使用します。 </simpara> </listitem> </varlistentry> @@ -37,6 +42,7 @@ <listitem> <simpara> 数値添字・フィールド名キーの両方の形式でカラムデータを返します。 + <function>ingres_fetch_array</function> で使用します。 </simpara> </listitem> </varlistentry> @@ -71,8 +77,10 @@ </term> <listitem> <simpara> - Ingres カーソルが 'readonly' モードでオープンされていることを表します。 + Ingres カーソルが "readonly" モードでオープンされていることを表します。 PECL 拡張モジュールのバージョン 1.2.0 以降で使用可能です。 + <link linkend="ini.ingres.cursor-mode">ingres.cursor_mode</link> + で使用します。 </simpara> </listitem> </varlistentry> @@ -83,8 +91,10 @@ </term> <listitem> <simpara> - Ingres カーソルが 'update' モードでオープンされていることを表します。 + Ingres カーソルが "for update" モードでオープンされていることを表します。 PECL 拡張モジュールのバージョン 1.2.0 以降で使用可能です。 + <link linkend="ini.ingres.cursor-mode">ingres.cursor_mode</link> + で使用します。 </simpara> </listitem> </varlistentry> @@ -97,6 +107,11 @@ <simpara> II_DATE_FORMAT の設定 MULTINATIONAL と等価です。 PECL 拡張モジュールのバージョン 1.2.0 以降で使用可能です。 + <function>ingres_connect</function>、<function>ingres_pconnect</function> + および <function>ingres_set_environment</function> で使用します。 + <function>ingres_set_environment</function> の + <link linkend="function.ingres-set-environment.options">オプション</link> + も参照ください。 </simpara> </listitem> </varlistentry> @@ -109,6 +124,11 @@ <simpara> II_DATE_FORMAT の設定 MULTINATIONAL4 と等価です。 PECL 拡張モジュールのバージョン 1.2.0 以降で使用可能です。 + <function>ingres_connect</function>、<function>ingres_pconnect</function> + および <function>ingres_set_environment</function> で使用します。 + <function>ingres_set_environment</function> の + <link linkend="function.ingres-set-environment.options">オプション</link> + も参照ください。 </simpara> </listitem> </varlistentry> @@ -121,6 +141,11 @@ <simpara> II_DATE_FORMAT の設定 FINNISH と等価です。 PECL 拡張モジュールのバージョン 1.2.0 以降で使用可能です。 + <function>ingres_connect</function>、<function>ingres_pconnect</function> + および <function>ingres_set_environment</function> で使用します。 + <function>ingres_set_environment</function> の + <link linkend="function.ingres-set-environment.options">オプション</link> + も参照ください。 </simpara> </listitem> </varlistentry> @@ -133,6 +158,11 @@ <simpara> II_DATE_FORMAT の設定 ISO と等価です。 PECL 拡張モジュールのバージョン 1.2.0 以降で使用可能です。 + <function>ingres_connect</function>、<function>ingres_pconnect</function> + および <function>ingres_set_environment</function> で使用します。 + <function>ingres_set_environment</function> の + <link linkend="function.ingres-set-environment.options">オプション</link> + も参照ください。 </simpara> </listitem> </varlistentry> @@ -145,6 +175,11 @@ <simpara> II_DATE_FORMAT の設定 ISO4 と等価です。 PECL 拡張モジュールのバージョン 1.2.0 以降で使用可能です。 + <function>ingres_connect</function>、<function>ingres_pconnect</function> + および <function>ingres_set_environment</function> で使用します。 + <function>ingres_set_environment</function> の + <link linkend="function.ingres-set-environment.options">オプション</link> + も参照ください。 </simpara> </listitem> </varlistentry> @@ -157,6 +192,11 @@ <simpara> II_DATE_FORMAT の設定 GERMAN と等価です。 PECL 拡張モジュールのバージョン 1.2.0 以降で使用可能です。 + <function>ingres_connect</function>、<function>ingres_pconnect</function> + および <function>ingres_set_environment</function> で使用します。 + <function>ingres_set_environment</function> の + <link linkend="function.ingres-set-environment.options">オプション</link> + も参照ください。 </simpara> </listitem> </varlistentry> @@ -169,6 +209,11 @@ <simpara> II_DATE_FORMAT の設定 MDY と等価です。 PECL 拡張モジュールのバージョン 1.2.0 以降で使用可能です。 + <function>ingres_connect</function>、<function>ingres_pconnect</function> + および <function>ingres_set_environment</function> で使用します。 + <function>ingres_set_environment</function> の + <link linkend="function.ingres-set-environment.options">オプション</link> + も参照ください。 </simpara> </listitem> </varlistentry> @@ -181,6 +226,11 @@ <simpara> II_DATE_FORMAT の設定 DMY と等価です。 PECL 拡張モジュールのバージョン 1.2.0 以降で使用可能です。 + <function>ingres_connect</function>、<function>ingres_pconnect</function> + および <function>ingres_set_environment</function> で使用します。 + <function>ingres_set_environment</function> の + <link linkend="function.ingres-set-environment.options">オプション</link> + も参照ください。 </simpara> </listitem> </varlistentry> @@ -193,6 +243,11 @@ <simpara> II_DATE_FORMAT の設定 YMD と等価です。 PECL 拡張モジュールのバージョン 1.2.0 以降で使用可能です。 + <function>ingres_connect</function>、<function>ingres_pconnect</function> + および <function>ingres_set_environment</function> で使用します。 + <function>ingres_set_environment</function> の + <link linkend="function.ingres-set-environment.options">オプション</link> + も参照ください。 </simpara> </listitem> </varlistentry> @@ -204,8 +259,13 @@ <listitem> <simpara> 金額の値の先頭に表示する文字を表します。 - II_MONEY_FORMAT の設定 'L:' と等価です。 + II_MONEY_FORMAT の設定 "L:" と等価です。 PECL 拡張モジュールのバージョン 1.2.0 以降で使用可能です。 + <function>ingres_connect</function>、<function>ingres_pconnect</function> + および <function>ingres_set_environment</function> で使用します。 + <function>ingres_set_environment</function> の + <link linkend="function.ingres-set-environment.options">オプション</link> + も参照ください。 </simpara> </listitem> </varlistentry> @@ -217,8 +277,13 @@ <listitem> <simpara> 金額の値の最後に表示する文字を表します。 - II_MONEY_FORMAT の設定 'T:' と等価です。 + II_MONEY_FORMAT の設定 "T:" と等価です。 PECL 拡張モジュールのバージョン 1.2.0 以降で使用可能です。 + <function>ingres_connect</function>、<function>ingres_pconnect</function> + および <function>ingres_set_environment</function> で使用します。 + <function>ingres_set_environment</function> の + <link linkend="function.ingres-set-environment.options">オプション</link> + も参照ください。 </simpara> </listitem> </varlistentry> @@ -233,6 +298,11 @@ これは、接続時のオプション table_structure あるいは index_structure と組み合わせて使用します。 PECL 拡張モジュールのバージョン 1.4.0 以降で使用可能です。 + <function>ingres_connect</function> および + <function>ingres_pconnect</function> で使用します。 + <function>ingres_connect</function> の + <link linkend="function.ingres-connect.options">オプション</link> + も参照ください。 </simpara> </listitem> </varlistentry> @@ -247,6 +317,11 @@ これは、接続時のオプション table_structure あるいは index_structure と組み合わせて使用します。 PECL 拡張モジュールのバージョン 1.4.0 以降で使用可能です。 + <function>ingres_connect</function> および + <function>ingres_pconnect</function> で使用します。 + <function>ingres_connect</function> の + <link linkend="function.ingres-connect.options">オプション</link> + も参照ください。 </simpara> </listitem> </varlistentry> @@ -261,6 +336,11 @@ これは、接続時のオプション table_structure あるいは index_structure と組み合わせて使用します。 PECL 拡張モジュールのバージョン 1.4.0 以降で使用可能です。 + <function>ingres_connect</function> および + <function>ingres_pconnect</function> で使用します。 + <function>ingres_connect</function> の + <link linkend="function.ingres-connect.options">オプション</link> + も参照ください。 </simpara> </listitem> </varlistentry> @@ -275,6 +355,11 @@ これは、接続時のオプション table_structure あるいは index_structure と組み合わせて使用します。 PECL 拡張モジュールのバージョン 1.4.0 以降で使用可能です。 + <function>ingres_connect</function> および + <function>ingres_pconnect</function> で使用します。 + <function>ingres_connect</function> の + <link linkend="function.ingres-connect.options">オプション</link> + も参照ください。 </simpara> </listitem> </varlistentry> @@ -289,6 +374,11 @@ これは、接続時のオプション table_structure あるいは index_structure と組み合わせて使用します。 PECL 拡張モジュールのバージョン 1.4.0 以降で使用可能です。 + <function>ingres_connect</function> および + <function>ingres_pconnect</function> で使用します。 + <function>ingres_connect</function> の + <link linkend="function.ingres-connect.options">オプション</link> + も参照ください。 </simpara> </listitem> </varlistentry> @@ -303,6 +393,11 @@ これは、接続時のオプション table_structure あるいは index_structure と組み合わせて使用します。 PECL 拡張モジュールのバージョン 1.4.0 以降で使用可能です。 + <function>ingres_connect</function> および + <function>ingres_pconnect</function> で使用します。 + <function>ingres_connect</function> の + <link linkend="function.ingres-connect.options">オプション</link> + も参照ください。 </simpara> </listitem> </varlistentry> @@ -317,6 +412,11 @@ これは、接続時のオプション table_structure あるいは index_structure と組み合わせて使用します。 PECL 拡張モジュールのバージョン 1.4.0 以降で使用可能です。 + <function>ingres_connect</function> および + <function>ingres_pconnect</function> で使用します。 + <function>ingres_connect</function> の + <link linkend="function.ingres-connect.options">オプション</link> + も参照ください。 </simpara> </listitem> </varlistentry> @@ -331,6 +431,11 @@ これは、接続時のオプション table_structure あるいは index_structure と組み合わせて使用します。 PECL 拡張モジュールのバージョン 1.4.0 以降で使用可能です。 + <function>ingres_connect</function> および + <function>ingres_pconnect</function> で使用します。 + <function>ingres_connect</function> の + <link linkend="function.ingres-connect.options">オプション</link> + も参照ください。 </simpara> </listitem> </varlistentry> http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/ingres-ii/configure.xml?r1=1.4&r2=1.5&diff_format=u Index: phpdoc-ja/reference/ingres-ii/configure.xml diff -u phpdoc-ja/reference/ingres-ii/configure.xml:1.4 phpdoc-ja/reference/ingres-ii/configure.xml:1.5 --- phpdoc-ja/reference/ingres-ii/configure.xml:1.4 Fri Jun 22 14:32:04 2007 +++ phpdoc-ja/reference/ingres-ii/configure.xml Sun Mar 15 08:03:20 2009 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.4 $ --> -<!-- EN-Revision: 1.5 Maintainer: hirokawa Status: ready --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.6 Maintainer: hirokawa Status: ready --> <!-- CREDITS: takagi --> <section xml:id="ingres.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.install; @@ -10,8 +10,15 @@ <link xlink:href="&url.pecl.package;ingres">&url.pecl.package;ingres</link>. </para> <para> - これらの関数を利用可能とするには、オプション - <option role="configure">--with-ingres[=DIR]</option> を付け、 Ingres + この PECL 拡張モジュールの DLL は <link + xlink:href="&url.ingres.peclext;">&url.ingres.peclext;</link> + からダウンロードできます。 + </para> + <para> + これらの関数を利用可能とするには、 + この拡張モジュールを <link + xlink:href="&url.pecl.package;ingres">ダウンロード</link> + し、<option role="configure">--with-ingres[=DIR]</option> を付け、Ingres サポートを有効にして PHP をコンパイルする必要があります。ただし、DIR は Ingres ベースディレクトリで、<filename>/II/ingres</filename> が デフォルトです。環境変数 II_SYSTEM が正しく設定されていない場合、 @@ -20,13 +27,38 @@ 必要となる可能性があります。 </para> <para> - この拡張モジュールを Apache で使用する際に Apache が起動せず、 - "PHP Fatal error: Unable to start - ingres_ii module in Unknown on line 0" というエラーが発生する場合、 - 環境変数 II_SYSTEM が正確に設定されているかどうかを確認してください。 - "export II_SYSTEM="/home/ingres/II" を Apache を開始するスクリプトに - 追加してください。この後に httpd を起動すればうまくいくはずです。 + バージョン 2.x 以降用に書かれた PHP コードは、この PHP + 拡張モジュールの以前のバージョンとの互換性はありません。 + しかし、<option role="configure">--enable-ingres2</option> + オプションを使用すれば、互換性のないふたつのリリースを同一の + PHP 環境で動かすことができます。この設定オプションは、 + 拡張モジュールの名前を ingres2 に変更し、 + 関数名や設定項目名そして定数名も変更します。 + たとえば、このオプションを有効にした場合 + <function>ingres_connect</function> は + <function>ingres2_connect</function> となります。 + </para> + <para> + この拡張モジュールを使用するには、環境変数 II_SYSTEM + を定義しておかなければなりません。Linux や UNIX のユーザは、 + さらに LD_LIBRARY_PATH などで共有ライブラリのサーチパスも定義しなければなりません。 + Apache web server で使用する場合は、これらの変数を + Apache の起動スクリプトで明示的に設定する必要があります。 + さらに、Ingres 拡張モジュールが正しい共有ライブラリを読み込めるように + PassEnv ディレクティブも必要となります。 </para> + <example> + <informalexample> + <screen> +<![CDATA[ +<IfModule mod_env.c> + PassEnv II_SYSTEM + PassEnv LD_LIBRARY_PATH +</IfModule> +]]> + </screen> + </informalexample> + </example> </section> <!-- Keep this comment at the end of the file