cvs: phpdoc-ja /appendices history.xml ini.xml /install/windows extensions.xml /language namespaces.xml /reference/ingres-ii book.xml ini.xml
/reference/ingres-ii/functions ingres-query.xml

From: Date: Fri, 13 Mar 2009 03:59:04 +0000
Subject: cvs: phpdoc-ja /appendices history.xml ini.xml /install/windows extensions.xml /language namespaces.xml /reference/ingres-ii book.xml ini.xml
/reference/ingres-ii/functions ingres-query.xml
Groups: php.doc.ja 
Request: Send a blank email to doc-ja+get-2434@lists.php.net to get a copy of this message
takagi Fri Mar 13 03:59:04 2009 UTC Modified files: /phpdoc-ja/reference/ingres-ii/functions ingres-query.xml /phpdoc-ja/reference/ingres-ii ini.xml book.xml /phpdoc-ja/language namespaces.xml /phpdoc-ja/install/windows extensions.xml /phpdoc-ja/appendices ini.xml history.xml Log: sync with en.

http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/ingres-ii/functions/ingres-query.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-ja/reference/ingres-ii/functions/ingres-query.xml diff -u phpdoc-ja/reference/ingres-ii/functions/ingres-query.xml:1.8 phpdoc-ja/reference/ingres-ii/functions/ingres-query.xml:1.9 --- phpdoc-ja/reference/ingres-ii/functions/ingres-query.xml:1.8 Sun Dec 28 01:32:27 2008 +++ phpdoc-ja/reference/ingres-ii/functions/ingres-query.xml Fri Mar 13 03:59:04 2009 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.9 Maintainer: hirokawa Status: ready --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.10 Maintainer: hirokawa Status: ready --> <!-- CREDITS: takagi --> <refentry xml:id="function.ingres-query" xmlns="http://docbook.org/ns/docbook"> <refnamediv> @@ -11,9 +11,11 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>bool</type><methodname>ingres_query</methodname> + <type>mixed</type><methodname>ingres_query</methodname> + <methodparam><type>resource</type><parameter>link</parameter></methodparam> <methodparam><type>string</type><parameter>query</parameter></methodparam> - <methodparam choice="opt"><type>resource</type><parameter>link</parameter></methodparam> + <methodparam choice="opt"><type>array</type><parameter>params</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>types</parameter></methodparam> </methodsynopsis> <para> <function>ingres_query</function> は、指定した @@ -33,6 +35,16 @@ <function>ingres_autocommit</function> を使用することも可能です。 この場合、各 SQL クエリは直ちにコミットされます。 </para> + <note> + <title>関連する設定項目</title> + <para> + <link linkend="ingres.configuration">実行時設定</link> での + <link linkend="ini.ingres.describe">ingres.describe</link>、 + <link linkend="ini.ingres.scrollable">ingres.scrollable</link> および + <link linkend="ini.ingres.utf8">ingres.utf8</link> + の説明も参照ください。 + </para> + </note> </refsect1> <refsect1 role="parameters"> @@ -40,11 +52,20 @@ <para> <variablelist> <varlistentry> + <term><parameter>link</parameter></term> + <listitem> + <para> + 接続リンク ID。 + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="function.ingres-query.query"> <term><parameter>query</parameter></term> <listitem> <para> 有効な SQL クエリ - (Ingres SQL リファレンスガイドを参照ください)。 + (Ingres ドキュメントにある Ingres <emphasis>SQL + リファレンスガイド</emphasis> を参照ください)。 </para> <para> 次の型の SQL クエリは、この関数で送信できません。 @@ -94,11 +115,89 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>link</parameter></term> + <term><parameter>params</parameter></term> + <listitem> + <para> + クエリで使用するパラメータの値のの配列。 + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="function.ingres-query.types"> + <term><parameter>types</parameter></term> <listitem> <para> - 接続リンク ID。省略した場合は、最後にオープンしたリンクを使用します。 + 渡されたパラメータの値の型を含む文字列。 + <link linkend="ini.ingres.describe">ingres.describe</link> が有効な場合は + このパラメータは無視され、サーバが期待している型をドライバが自動的に取得します。 </para> + <informaltable> + <tgroup cols='4'> + <thead> + <row> + <entry>型コード</entry> + <entry>Ingres の型</entry> + </row> + </thead> + <tbody> + <row> + <entry>b</entry> + <entry><type>BYTE</type></entry> + </row> + <row> + <entry>B</entry> + <entry><type>LONG BYTE/BLOB</type></entry> + </row> + <row> + <entry>c</entry> + <entry><type>CHAR</type></entry> + </row> + <row> + <entry>d</entry> + <entry><type>DATE/ANSIDATE/TIMESTAMP/TIME</type></entry> + </row> + <row> + <entry>f</entry> + <entry><type>FLOAT</type></entry> + </row> + <row> + <entry>i</entry> + <entry><type>INTEGER</type></entry> + </row> + <row> + <entry>L</entry> + <entry><type>LONG TEXT</type></entry> + </row> + <row> + <entry>m</entry> + <entry><type>MONEY</type></entry> + </row> + <row> + <entry>M</entry> + <entry><type>LONG NVARCHAR</type></entry> + </row> + <row> + <entry>n</entry> + <entry><type>NCHAR</type></entry> + </row> + <row> + <entry>N</entry> + <entry><type>NVARCHAR</type></entry> + </row> + <row> + <entry>t</entry> + <entry><type>TEXT</type></entry> + </row> + <row> + <entry>v</entry> + <entry><type>VARCHAR</type></entry> + </row> + <row> + <entry>V</entry> + <entry><type>LONG VARCHAR</type></entry> + </row> + </tbody> + </tgroup> + </informaltable> </listitem> </varlistentry> </variablelist> @@ -108,7 +207,14 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - &return.success; + <function>ingres_query</function> は、 + 取得する行がある場合はクエリ結果 ID を返します。 + それ以外の場合 (INSERT、UPDATE あるいは DELETE 文の場合) + は &false; を返します。 + エラーが発生したかどうかを知るには + <function>ingres_errno</function>、 + <function>ingres_error</function> あるいは + <function>ingres_errsqlstate</function> を使用します。 </para> </refsect1> @@ -116,14 +222,32 @@ &reftitle.examples; <para> <example> - <title><function>ingres_query</function> の例</title> + <title>単純な select の送信</title> + <programlisting role="php"> +<![CDATA[ +<?php +$link = ingres_connect("demodb"); + +$result = ingres_query($link, "select * from user_profile"); +while ($row = ingres_fetch_row($result)) { + echo $row[1]; + echo $row[2]; +} +?> +]]> + </programlisting> + </example> + <example> + <title><function>ingres_query</function> へクエリパラメータを渡す</title> <programlisting role="php"> <![CDATA[ <?php -ingres_connect($database, $user, $password); +$link = ingres_connect("demodb"); -ingres_query("select * from table"); -while ($row = ingres_fetch_row()) { +$params[] = "Emma"; +$query = "select * from user_profile where up_first = ?"; +$result = ingres_query($link, $query, $params); +while ($row = ingres_fetch_row($result)) { echo $row[1]; echo $row[2]; } @@ -131,6 +255,40 @@ ]]> </programlisting> </example> + <example> + <title>パラメータの型を指定した BLOB の挿入</title> + <programlisting role="php"> +<![CDATA[ +<?php +$link = ingres_connect("demodb"); + +// 写真をオープンします +$fh = fopen("photo.jpg","r"); +$blob_data = stream_get_contents($fh); +fclose($fh); + +// パラメータを準備します +$params[] = $blob_data; +$params[] = 1201; + +// パラメータの型を定義します +$param_types = "Bi"; + +$query = "update user_profile set up_image = ? where up_id = ?"; +$result = ingres_query($link, $query , $params, $param_types); + +if (ingres_errno()) +{ + echo ingres_errno() . "-" . ingres_error() . "\n"; +} + +ingres_commit($link); + +ingres_close($link); +?> +]]> + </programlisting> + </example> </para> </refsect1> @@ -138,12 +296,16 @@ &reftitle.seealso; <para> <simplelist> + <member><function>ingres_unbuffered_query</function></member> <member><function>ingres_fetch_array</function></member> <member><function>ingres_fetch_object</function></member> <member><function>ingres_fetch_row</function></member> <member><function>ingres_commit</function></member> <member><function>ingres_rollback</function></member> <member><function>ingres_autocommit</function></member> + <member><function>ingres_set_environment</function></member> + <member><function>ingres_errno</function></member> + <member><function>ingres_error</function></member> </simplelist> </para> </refsect1> http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/ingres-ii/ini.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-ja/reference/ingres-ii/ini.xml diff -u phpdoc-ja/reference/ingres-ii/ini.xml:1.7 phpdoc-ja/reference/ingres-ii/ini.xml:1.8 --- phpdoc-ja/reference/ingres-ii/ini.xml:1.7 Sun Sep 30 04:48:33 2007 +++ phpdoc-ja/reference/ingres-ii/ini.xml Fri Mar 13 03:59:04 2009 @@ -1,100 +1,370 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.9 Maintainer: hirokawa Status: ready --> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.10 Maintainer: hirokawa Status: ready --> <!-- CREDITS: takagi --> <section xml:id="ingres.configuration" xmlns="http://docbook.org/ns/docbook"> &reftitle.runtime; &extension.runtime; <para> - <table> - <title>Ingres 設定オプション</title> - <tgroup cols="4"> - <thead> - <row> - <entry>名前</entry> - <entry>デフォルト</entry> - <entry>変更の可否</entry> - <entry>変更履歴</entry> - </row> - </thead> - <tbody> - <row> - <entry>ingres.allow_persistent</entry> - <entry>"1"</entry> + <table> + <title>Ingres 設定オプション</title> + <tgroup cols="4"> + <thead align="left"> + <row> + <entry>名前</entry> + <entry>デフォルト</entry> + <entry>変更の可否</entry> + <entry>変更履歴</entry> + </row> + </thead> + <tbody> + <row> + <entry><link + linkend="ini.ingres.allow-persistent">ingres.allow_persistent</link></entry> + <entry>"1"</entry> <entry>PHP_INI_SYSTEM</entry> - <entry>PHP 4.0.2 以降で使用可能です。PHP 5.1.0 で削除されました。</entry> - </row> - <row> - <entry>ingres.max_persistent</entry> - <entry>"-1"</entry> - <entry>PHP_INI_SYSTEM</entry> - <entry>PHP 4.0.2 以降で使用可能です。PHP 5.1.0 で削除されました。</entry> - </row> - <row> - <entry>ingres.max_links</entry> - <entry>"-1"</entry> - <entry>PHP_INI_SYSTEM</entry> - <entry>PHP 4.0.2 以降で使用可能です。PHP 5.1.0 で削除されました。</entry> - </row> - <row> - <entry>ingres.default_database</entry> - <entry>NULL</entry> - <entry>PHP_INI_ALL</entry> - <entry>PHP 4.0.2 以降で使用可能です。PHP 5.1.0 で削除されました。</entry> - </row> - <row> - <entry>ingres.default_user</entry> - <entry>NULL</entry> - <entry>PHP_INI_ALL</entry> - <entry>PHP 4.0.2 以降で使用可能です。PHP 5.1.0 で削除されました。</entry> - </row> - <row> - <entry>ingres.default_password</entry> - <entry>NULL</entry> - <entry>PHP_INI_ALL</entry> - <entry>PHP 4.0.2 以降で使用可能です。PHP 5.1.0 で削除されました。</entry> - </row> + <entry>ingres 1.0.0 以降で使用可能です。</entry> + </row> <row> - <entry>ingres.report_db_warnings</entry> + <entry><link + linkend="ini.ingres.array-index-start">ingres.array_index_start</link></entry> <entry>"1"</entry> <entry>PHP_INI_ALL</entry> - <entry>ingres 1.1 以降で使用可能です。</entry> + <entry>ingres 1.4.0 以降で使用可能です。</entry> </row> <row> - <entry>ingres.cursor_mode</entry> - <entry>"0"</entry> + <entry><link linkend="ini.ingres.auto">ingres.auto</link></entry> + <entry>"1"</entry> <entry>PHP_INI_ALL</entry> - <entry>ingres 1.1 以降で使用可能です。</entry> + <entry>ingres 2.0.0 以降で使用可能です。</entry> </row> <row> - <entry>ingres.blob_segment_length</entry> + <entry><link + linkend="ini.ingres.blob-segment-length">ingres.blob_segment_length</link></entry> <entry>"4096"</entry> <entry>PHP_INI_ALL</entry> <entry>ingres 1.2.0 以降で使用可能です。</entry> </row> <row> - <entry>ingres.trace_connect</entry> + <entry><link linkend="ini.ingres.cursor-mode">ingres.cursor_mode</link></entry> <entry>"0"</entry> <entry>PHP_INI_ALL</entry> - <entry>ingres 1.2.1 以降で使用可能です。</entry> + <entry>ingres 1.1.0 以降で使用可能です。</entry> </row> <row> - <entry>ingres.timeout</entry> + <entry><link + linkend="ini.ingres.default-database">ingres.default_database</link></entry> + <entry>NULL</entry> + <entry>PHP_INI_ALL</entry> + <entry>ingres 1.0.0 以降で使用可能です。</entry> + </row> + <row> + <entry><link + linkend="ini.ingres.default-password">ingres.default_password</link></entry> + <entry>NULL</entry> + <entry>PHP_INI_ALL</entry> + <entry>ingres 1.0.0 以降で使用可能です。</entry> + </row> + <row> + <entry><link linkend="ini.ingres.default-user">ingres.default_user</link></entry> + <entry>NULL</entry> + <entry>PHP_INI_ALL</entry> + <entry>ingres 1.0.0 以降で使用可能です。</entry> + </row> + <row> + <entry><link linkend="ini.ingres.describe">ingres.describe</link></entry> + <entry>1</entry> + <entry>PHP_INI_ALL</entry> + <entry>ingres 2.1.0 以降で使用可能です。</entry> + </row> + <row> + <entry><link + linkend="ini.ingres.fetch-buffer-size">ingres.fetch_buffer_size</link></entry> + <entry>100</entry> + <entry>PHP_INI_ALL</entry> + <entry>ingres 2.1.0 以降で使用可能です。</entry> + </row> + <row> + <entry><link linkend="ini.ingres.max-links">ingres.max_links</link></entry> <entry>"-1"</entry> + <entry>PHP_INI_SYSTEM</entry> + <entry>ingres 1.0.0 以降で使用可能です。</entry> + </row> + <row> + <entry><link + linkend="ini.ingres.max-persistent">ingres.max_persistent</link></entry> + <entry>"-1"</entry> + <entry>PHP_INI_SYSTEM</entry> + <entry>ingres 1.0.0 以降で使用可能です。</entry> + </row> + <row> + <entry><link + linkend="ini.ingres.reuse-connection">ingres.reuse_connection</link></entry> + <entry>"1"</entry> <entry>PHP_INI_ALL</entry> - <entry>ingres 1.4.0 以降で使用可能です。</entry> + <entry>ingres 2.0.0 以降で使用可能です。</entry> </row> <row> - <entry>ingres.array_index_start</entry> + <entry><link linkend="ini.ingres.scrollable">ingres.scrollable</link></entry> <entry>"1"</entry> <entry>PHP_INI_ALL</entry> - <entry>ingres 1.4.0 以降で使用可能です。</entry> + <entry>ingres 2.0.0 以降で使用可能です。</entry> + </row> + <row> + <entry><link linkend="ini.ingres.trace">ingres.trace</link></entry> + <entry>"0"</entry> + <entry>PHP_INI_ALL</entry> + <entry>ingres 2.0.0 以降で使用可能です。</entry> + </row> + <row> + <entry><link + linkend="ini.ingres.trace-connect">ingres.trace_connect</link></entry> + <entry>"0"</entry> + <entry>PHP_INI_ALL</entry> + <entry>ingres 1.2.1 以降で使用可能です。</entry> + </row> + <row> + <entry><link linkend="ini.ingres.utf8">ingres.utf8</link></entry> + <entry>"1"</entry> + <entry>PHP_INI_ALL</entry> + <entry>ingres 2.0.0 以降で使用可能です。</entry> </row> </tbody> </tgroup> </table> &ini.php.constants; </para> + + &ini.descriptions.title; + + <para> + <variablelist> + <varlistentry xml:id="ini.ingres.allow-persistent"> + <term> + <parameter>ingres.allow_persistent</parameter> + <type>boolean</type> + </term> + <listitem> + <para> + Ingres への + <link linkend="features.persistent-connections">持続的接続</link> + を許可するかどうかを設定します。 + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.ingres.array-index-start"> + <term> + <parameter>ingres.array_index_start</parameter> + <type>integer</type> + </term> + <listitem> + <para> + <function>ingres_fetch_array</function> および + <function>ingres_fetch_row</function> が返す配列のインデックスをデフォルトで 1 + からにするよう設定します。Ingres 拡張モジュールの動作を + 他のデータベース用の拡張モジュールとそろえるには、これを 0 に設定します。 + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.ingres.auto"> + <term> + <parameter>ingres.auto</parameter> + <type>boolean</type> + </term> + <listitem> + <para> + 自動コミットのエミュレート機能を有効あるいは無効にします。 + Ingres で複数のカーソルを開くには、自動コミットを有効にしなければなりません。 + これを有効にすると、ドライバが自動コミット機能をエミュレートします。 + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.ingres.blob-segment-length"> + <term> + <parameter>ingres.blob_segment_length</parameter> + <type>integer</type> + </term> + <listitem> + <para> + BLOB データの読み込み時に使用するメモリの量をバイト単位で指定します。 + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.ingres.cursor-mode"> + <term> + <parameter>ingres.cursor_mode</parameter> + <type>integer</type> + </term> + <listitem> + <para> + ingres_prepare() でカーソルを開く際のデフォルトのモードを指定します。 + INGRES_CURSOR_UPDATE あるいは INGRES_CURSOR_READONLY のいずれかです。 + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.ingres.default-database"> + <term> + <parameter>ingres.default_database</parameter> + <type>string</type> + </term> + <listitem> + <para> + データベースサーバへの接続時に名前を指定しなかった場合に使用する + デフォルトのデータベース名を指定します。 + &sqlsafemode; の場合は適用されません。 + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.ingres.default-password"> + <term> + <parameter>ingres.default_password</parameter> + <type>string</type> + </term> + <listitem> + <para> + データベースサーバへの接続時に名前を指定しなかった場合に使用する + デフォルトのパスワードを指定します。 + &sqlsafemode; の場合は適用されません。 + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.ingres.default-user"> + <term> + <parameter>ingres.default_user</parameter> + <type>string</type> + </term> + <listitem> + <para> + データベースサーバへの接続時に名前を指定しなかった場合に使用する + デフォルトのユーザ名を指定します。 + &sqlsafemode; の場合は適用されません。 + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.ingres.describe"> + <term> + <parameter>ingres.describe</parameter> + <type>boolean</type> + </term> + <listitem> + <para> + パラメータを使うクエリで期待しているデータ型を + DESCRIBE INPUT で調べられるようにします。 + Ingres 9.1.0 以降で使用可能です。無効にすると、パラメータつきクエリを渡された場合に + <function>ingres_query</function> の + <link linkend="function.ingres-query.types">types</link> + パラメータで型を自分で調べなければならなくなります。 + </para> + <note> + <para> + この機能を有効にして ingres_query() を使用すると、 + この拡張モジュールとサーバとの間でのトラフィックが増加します。 + トラフィックの増加を最小限に抑えるには、ingres_prepare() および + ingres_execute() を使用します。 + </para> + </note> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.ingres.fetch-buffer-size"> + <term> + <parameter>ingres.fetch_buffer_size</parameter> + <type>integer</type> + </term> + <listitem> + <para> + <function>ingres_fetch_array</function>、 + <function>ingres_fetch_object</function> および + <function>ingres_fetch_row</function> が一度のフェッチ操作で事前取得を試みる行数を指定します。 + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.ingres.max-links"> + <term> + <parameter>ingres.max_links</parameter> + <type>integer</type> + </term> + <listitem> + <para> + プロセス単位あるいはスレッド単位で使用できる Ingres セッションの最大数を指定します。 + このセッション数は、Ingres で設定されている接続セッション数の総数を超えてはいけません。 + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.ingres.max-persistent"> + <term> + <parameter>ingres.max_persistent</parameter> + <type>integer</type> + </term> + <listitem> + <para> + プロセス単位あるいはスレッド単位で使用できる持続的 Ingres セッションの最大数を指定します。 + このセッション数は、Ingres で設定されている接続セッション数の総数を超えてはいけません。 + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.ingres.reuse-connection"> + <term> + <parameter>ingres.reuse_connection</parameter> + <type>boolean</type> + </term> + <listitem> + <para> + 同一データベースへの同一ユーザ名での接続があった場合に、 + 既存のアクティブな接続を再利用します。 + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.ingres.scrollable"> + <term> + <parameter>ingres.scrollable</parameter> + <type>boolean</type> + </term> + <listitem> + <para> + スクロール可能なカーソルのサポートを有効にします。CLOB あるいは BLOB + データを取得する際にはこれを &false; にしておかなければなりません。 + Ingres 9.2.0 以降で使用可能です。 + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.ingres.trace"> + <term> + <parameter>ingres.trace</parameter> + <type>boolean</type> + </term> + <listitem> + <para> + E_NOTICE メッセージによるシンプルなトレース機能を有効にします。 + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.ingres.trace-connect"> + <term> + <parameter>ingres.trace_connect</parameter> + <type>boolean</type> + </term> + <listitem> + <para> + ingres_connect あるいは ingres_pconnect のコール時に E_NOTICE メッセージを表示します。 + </para> + </listitem> + </varlistentry> + <varlistentry xml:id="ini.ingres.utf8"> + <term> + <parameter>ingres.utf8</parameter> + <type>boolean</type> + </term> + <listitem> + <para> + National Character 型のカラム + (NVARCHAR あるいは NCHAR) に渡された文字列が UTF8 エンコーディングを使用しているものとみなし、 + サーバ用に UTF16 に変換します。 + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </section> <!-- Keep this comment at the end of the file http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/ingres-ii/book.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-ja/reference/ingres-ii/book.xml diff -u phpdoc-ja/reference/ingres-ii/book.xml:1.2 phpdoc-ja/reference/ingres-ii/book.xml:1.3 --- phpdoc-ja/reference/ingres-ii/book.xml:1.2 Sun Dec 28 01:32:27 2008 +++ phpdoc-ja/reference/ingres-ii/book.xml Fri Mar 13 03:59:04 2009 @@ -1,29 +1,24 @@ <?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 --> <!-- Purpose: database.vendors --> <!-- Membership: pecl, external --> <book xml:id="book.ingres" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> - <title>Ingres</title> + <title>Ingres DBMS, EDBC および Enterprise Access Gateways</title> + <titleabbrev>Ingres</titleabbrev> <!-- {{{ preface --> <preface xml:id="intro.ingres"> &reftitle.intro; <para> - これらの関数により、Ingres RDBMS にアクセスできるようになります。 + PHP 用の Ingres ドライバを使用すると、Ingres + DBMS, EDBC および Enterprise Access Gateways への接続と問い合わせが可能となります。 </para> <note> <para> - 既に他のデータベースサーバにアクセスするための PHP 拡張モジュールを - 使用している場合、Ingres は同一のコネクションについて複数のクエリや - トランザクションの並列実行ができない、つまり、この拡張モジュールに - おいて結果およびトランザクションのハンドルを得ることができないことに - 注意する必要があります。クエリの結果は、別のクエリを送信する前に - 処理する必要があり、トランザクションは別のトランザクションを - オープンする前にコミットまたはロールバックする必要があります - (これは、最初のクエリを送信する際に自動的に行われます)。 + &pecl.moved-ver;5.1.0. </para> </note> </preface> http://cvs.php.net/viewvc.cgi/phpdoc-ja/language/namespaces.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-ja/language/namespaces.xml diff -u phpdoc-ja/language/namespaces.xml:1.8 phpdoc-ja/language/namespaces.xml:1.9 --- phpdoc-ja/language/namespaces.xml:1.8 Wed Mar 11 03:41:08 2009 +++ phpdoc-ja/language/namespaces.xml Fri Mar 13 03:59:04 2009 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="UTF-8"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.10 Maintainer: takagi Status: working --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.11 Maintainer: takagi Status: working --> <chapter xml:id="language.namespaces" xmlns="http://docbook.org/ns/docbook" version="1.1"> <title>名前空間</title> @@ -141,7 +141,7 @@ </example> 上の例は、定数 <literal>MyProject\Sub\Level\CONNECT_OK</literal> とクラス <literal>MyProject\Sub\Level\Connection</literal>、 - そして関数 <literal>MyProject\Sub\Level\Connection</literal> を作成します。 + そして関数 <literal>MyProject\Sub\Level\connect</literal> を作成します。 </para> </sect1> <sect1 xml:id="language.namespaces.definitionmultiple"> @@ -965,64 +965,62 @@ </example> </sect1> <sect1 xml:id="language.namespaces.faq"> - <title>FAQ: things you need to know about namespaces</title> + <title>FAQ: 名前空間について知っておくべきこと</title> <para> - This FAQ is split into two sections: common questions, and some specifics of - implementation that are helpful to understand fully. + この FAQ は 2 つに別れています。一般的な質問と、 + 深く理解するために有用な実装に関する質問です。 </para> <para> - First, the common questions. + まずは一般的な質問。 <orderedlist> <listitem> <simpara> - <link linkend="language.namespaces.faq.shouldicare">If I don't use namespaces, should - I care about any of this?</link> + <link linkend="language.namespaces.faq.shouldicare">名前空間を使わない場合、 + 何か注意すべきことはありますか?</link> </simpara> </listitem> <listitem> <simpara> - <link linkend="language.namespaces.faq.globalclass">How do I use internal or global - classes in a namespace?</link> + <link linkend="language.namespaces.faq.globalclass"> + 名前空間内での内部クラスあるいはグローバルクラスの使用法は?</link> </simpara> </listitem> <listitem> <simpara> - <link linkend="language.namespaces.faq.innamespace">How do I use namespaces classes - functions, or constants in their own namespace?</link> + <link linkend="language.namespaces.faq.innamespace"> + 同じ名前空間にあるクラス、関数あるいは定数を使用する方法は?</link> </simpara> </listitem> <listitem> <simpara> <link linkend="language.namespaces.faq.full"> - How does a name like <literal>\my\name</literal> or <literal>\name</literal> - resolve? + <literal>\my\name</literal> や <literal>\name</literal> + のような名前はどのように解決される? </link> </simpara> </listitem> <listitem> <simpara> - <link linkend="language.namespaces.faq.qualified">How does a name like - <literal>my\name</literal> resolve?</link> + <link linkend="language.namespaces.faq.qualified"> + <literal>my\name</literal> のような名前はどのように解決される?</link> </simpara> </listitem> <listitem> <simpara> - <link linkend="language.namespaces.faq.shortname1">How does an unqualified class name - like <literal>name</literal> resolve?</link> + <link linkend="language.namespaces.faq.shortname1"> + 修飾されていない <literal>name</literal> のようなクラス名はどのように解決される?</link> </simpara> </listitem> <listitem> <simpara> - <link linkend="language.namespaces.faq.shortname2">How does an unqualified function - name or unqualified constant name - like <literal>name</literal> resolve?</link> + <link linkend="language.namespaces.faq.shortname2"> + 修飾されていない <literal>name</literal> のような関数名/定数名はどのように解決される?</link> </simpara> </listitem> </orderedlist> </para> <para> - There are a few implementation details of the namespace implementations - that are helpful to understand. + また、名前空間の実装を理解するために有用な実装の詳細は次のとおりです。 <orderedlist> <listitem> <simpara> @@ -1064,15 +1062,15 @@ </orderedlist> </para> <sect2 xml:id="language.namespaces.faq.shouldicare"> - <title>If I don't use namespaces, should I care about any of this?</title> + <title>名前空間を使わない場合、何か注意すべきことはありますか?</title> <para> - No. Namespaces do not affect any existing code in any way, or any - as-yet-to-be-written code that does not contain namespaces. You can - write this code if you wish: + いいえ。これまで書いてきたコード、今後書く名前空間を含まないコードのいずれについても、 + 名前空間が何らかの影響を及ぼすことはありません。 + お望みなら名前空間を使わないコードを書くこともできます。 </para> <para> <example> - <title>Accessing global classes outside a namespace</title> + <title>名前空間の外部にあるグローバルクラスへのアクセス</title> <programlisting role="php"> <![CDATA[ <?php @@ -1082,11 +1080,11 @@ </example> </para> <para> - This is functionally equivalent to: + これは、機能的に次と同等です。 </para> <para> <example> - <title>Accessing global classes outside a namespace</title> + <title>名前空間の外部にあるグローバルクラスへのアクセス</title> <programlisting role="php"> <![CDATA[ <?php @@ -1097,10 +1095,10 @@ </para> </sect2> <sect2 xml:id="language.namespaces.faq.globalclass"> - <title>How do I use internal or global classes in a namespace?</title> + <title>名前空間内での内部クラスあるいはグローバルクラスの使用法は?</title> <para> <example> - <title>Accessing internal classes in namespaces</title> + <title>名前空間内からの内部クラスへのアクセス</title> <programlisting role="php"> <![CDATA[ <?php @@ -1111,7 +1109,7 @@ $a = \DirectoryIterator::CURRENT_AS_FILEINFO; -// extending an internal or global class +// 内部クラス/グローバルクラスの継承 class MyException extends \Exception {} ?> ]]> @@ -1121,12 +1119,11 @@ </sect2> <sect2 xml:id="language.namespaces.faq.innamespace"> <title> - How do I use namespaces classes, functions, or constants in their own - namespace? + 同じ名前空間にあるクラス、関数あるいは定数を使用する方法は? </title> <para> <example> - <title>Accessing internal classes, functions or constants in namespaces</title> + <title>名前空間内のクラス、関数あるいは定数へのアクセス</title> <programlisting role="php"> <![CDATA[ <?php @@ -1134,18 +1131,18 @@ class MyClass {} -// using a class from the current namespace as a type hint +// 現在の名前空間のクラスをタイプヒントに使用する方法 function test(MyClass $typehintexample = null) {} -// another way to use a class from the current namespace as a type hint +// 現在の名前空間のクラスをタイプヒントに使用するもうひとつの方法 function test(\foo\MyClass $typehintexample = null) {} -// extending a class from the current namespace +// 現在の名前空間のクラスの継承 class Extended extends MyClass {} -// accessing a global function +// グローバル関数へのアクセス $a = \globalfunc(); -// accessing a global constant +// グローバル定数へのアクセス $b = \INI_ALL; ?> ]]> @@ -1155,22 +1152,22 @@ </sect2> <sect2 xml:id="language.namespaces.faq.full"> <title> - How does a name like <literal>\my\name</literal> or <literal>\name</literal> - resolve? + <literal>\my\name</literal> や <literal>\name</literal> + のような名前はどのように解決される? </title> <para> - Names that begin with a <literal>\</literal> always resolve to what they - look like, so <literal>\my\name</literal> is in fact <literal>my\name</literal>, - and <literal>\Exception</literal> is <literal>Exception</literal>. + <literal>\</literal> から始まる名前は常に見た目のままに解釈されます。 + つまり <literal>\my\name</literal> は <literal>my\name</literal> であり、 + <literal>\Exception</literal> は <literal>Exception</literal> となります。 <example> - <title>Fully Qualified names</title> + <title>完全修飾名</title> <programlisting role="php"> <![CDATA[ <?php namespace foo; -$a = new \my\name(); // instantiates "my\name" class -echo \strlen('hi'); // calls function "strlen" -$a = \INI_ALL; // $a is set to the value of constant "INI_ALL" +$a = new \my\name(); // "my\name" クラスのインスタンスを作成します +echo \strlen('hi'); // "strlen" 関数をコールします +$a = \INI_ALL; // $a に定数 "INI_ALL" の値を設定します ?> ]]> </programlisting> @@ -1178,32 +1175,32 @@ </para> </sect2> <sect2 xml:id="language.namespaces.faq.qualified"> - <title>How does a name like <literal>my\name</literal> resolve?</title> + <title><literal>my\name</literal> のような名前はどのように解決される?</title> <para> - Names that contain a backslash but do not begin with a backslash like - <literal>my\name</literal> can be resolved in 2 different ways. + 名前にバックスラッシュを含むが先頭はバックスラッシュでない名前、たとえば + <literal>my\name</literal> のような名前は 2 通りの方法で解釈されます。 </para> <para> - If there is - an import statement that aliases another name to <literal>my</literal>, then - the import alias is applied to the <literal>my</literal> in <literal>my\name</literal>. + 別の名前に <literal>my</literal> というエイリアスを指定する import + 文がある場合は、そのエイリアスが <literal>my\name</literal> + の <literal>my</literal> 部分に適用されます。 </para> <para> - Otherwise, the current namespace name is prepended to <literal>my\name</literal>. + それ以外の場合は、現在の名前空間が <literal>my\name</literal> の先頭に付け加えられます。 </para> <para> <example> - <title>Qualified names</title> + <title>修飾名</title> <programlisting role="php"> <![CDATA[ <?php namespace foo; use blah\blah as foo; -$a = new my\name(); // instantiates "foo\my\name" class -foo\bar::name(); // calls static method "name" in class "blah\blah\bar" -my\bar(); // calls function "foo\my\bar" -$a = my\BAR; // sets $a to the value of constant "foo\my\BAR" +$a = new my\name(); // "foo\my\name" クラスのインスタンスを作成します +foo\bar::name(); // "blah\blah\bar" の静的メソッド "name" をコールします +my\bar(); // "foo\my\bar" 関数をコールします +$a = my\BAR; // $a に定数 "foo\my\BAR" の値を設定します ?> ]]> </programlisting> @@ -1211,30 +1208,29 @@ </para> </sect2> <sect2 xml:id="language.namespaces.faq.shortname1"> - <title>How does an unqualified class name like <literal>name</literal> resolve?</title> + <title>修飾されていない <literal>name</literal> のようなクラス名はどのように解決される?</title> <para> - Class names that do not contain a backslash like - <literal>name</literal> can be resolved in 2 different ways. + バックスラッシュを含まない <literal>name</literal> のようなクラス名は + 2 通りの方法で解釈されます。 </para> <para> - If there is - an import statement that aliases another name to <literal>name</literal>, then - the import alias is applied. + 別の名前に <literal>name</literal> というエイリアスを指定する import + 文がある場合は、そのエイリアスが適用されます。 </para> <para> - Otherwise, the current namespace name is prepended to <literal>name</literal>. + それ以外の場合は、現在の名前空間が <literal>name</literal> の先頭に付け加えられます。 </para> <para> <example> - <title>Unqualified class names</title> + <title>非修飾クラス名</title> <programlisting role="php"> <![CDATA[ <?php namespace foo; use blah\blah as foo; -$a = new name(); // instantiates "foo\name" class -foo::name(); // calls static method "name" in class "blah\blah" +$a = new name(); // "foo\name" クラスのインスタンスを作成します +foo::name(); // "blah\blah" クラスの静的メソッド "name" をコールします ?> ]]> </programlisting> @@ -1243,24 +1239,23 @@ </sect2> <sect2 xml:id="language.namespaces.faq.shortname2"> <title> - How does an unqualified function name or unqualified constant name - like <literal>name</literal> resolve? + 修飾されていない <literal>name</literal> のような関数名/定数名はどのように解決される? </title> <para> - Function or constant names that do not contain a backslash like - <literal>name</literal> can be resolved in 2 different ways. + バックスラッシュを含まない <literal>name</literal> のような関数名/定数名は + 2 通りの方法で解釈されます。 </para> <para> - First, the current namespace name is prepended to <literal>name</literal>. + まず、現在の名前空間が <literal>name</literal> の先頭に付け加えられます。 </para> <para> - Finally, if the constant or function <literal>name</literal> does not exist - in the current namespace, a global constant or function <literal>name</literal> - is used if it exists. + 現在の名前空間に <literal>name</literal> という関数あるいは定数がない場合は、 + グローバル関数あるいは定数に <literal>name</literal> + があればそれを使用します。 </para> <para> <example> - <title>Unqualified function or constant names</title> + <title>非修飾関数/定数名</title> <programlisting role="php"> <![CDATA[ <?php @@ -1278,10 +1273,10 @@ return $a; } -my(); // calls "foo\my" -$a = strlen('hi'); // calls global function "strlen" because "foo\strlen" does not exist +my(); // "foo\my" をコールします +$a = strlen('hi'); // "foo\strlen" が存在しないので、グローバル関数 "strlen" をコールします $arr = array(1,3,2); -$b = sort($arr); // calls function "foo\sort" +$b = sort($arr); // "foo\sort" 関数をコールします $c = foo(); // calls function "foo\foo" - import is not applied $a = FOO; // sets $a to value of constant "foo\FOO" - import is not applied http://cvs.php.net/viewvc.cgi/phpdoc-ja/install/windows/extensions.xml?r1=1.7&r2=1.8&diff_format=u Index: phpdoc-ja/install/windows/extensions.xml diff -u phpdoc-ja/install/windows/extensions.xml:1.7 phpdoc-ja/install/windows/extensions.xml:1.8 --- phpdoc-ja/install/windows/extensions.xml:1.7 Thu Mar 20 05:28:26 2008 +++ phpdoc-ja/install/windows/extensions.xml Fri Mar 13 03:59:04 2009 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="UTF-8"?> -<!-- $Revision: 1.7 $ --> -<!-- EN-Revision: 1.18 Maintainer: haruki Status: ready --> +<!-- $Revision: 1.8 $ --> +<!-- EN-Revision: 1.19 Maintainer: haruki Status: ready --> <!-- CREDITS: fujimoto, hirokawa, yuw, haruki, takagi --> <sect1 xml:id="install.windows.extensions" xmlns="http://docbook.org/ns/docbook"> <title>Windows 用 PHP 拡張モジュール</title> @@ -281,8 +281,8 @@ </row> <row> <entry>php_ingres.dll</entry> - <entry><link linkend="ref.ingres">Ingres II</link> 関数</entry> - <entry>Ingres II ライブラリが必要</entry> + <entry><link linkend="ref.ingres">Ingres</link> 関数</entry> + <entry>Ingres ライブラリが必要</entry> </row> <row> <entry>php_interbase.dll</entry> http://cvs.php.net/viewvc.cgi/phpdoc-ja/appendices/ini.xml?r1=1.53&r2=1.54&diff_format=u Index: phpdoc-ja/appendices/ini.xml diff -u phpdoc-ja/appendices/ini.xml:1.53 phpdoc-ja/appendices/ini.xml:1.54 --- phpdoc-ja/appendices/ini.xml:1.53 Wed Feb 4 00:57:51 2009 +++ phpdoc-ja/appendices/ini.xml Fri Mar 13 03:59:04 2009 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.53 $ --> -<!-- EN-Revision: 1.83 Maintainer: hirokawa Status: ready --> +<!-- $Revision: 1.54 $ --> +<!-- EN-Revision: 1.84 Maintainer: hirokawa Status: ready --> <!-- CREDITS: takagi,shimooka --> <appendix xml:id="ini" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -3008,12 +3008,6 @@ <entry>PHP 6.0.0 以降で利用可能。</entry> </row> <row> - <entry>unicode.semantics</entry> - <entry>"0"</entry> - <entry>PHP_INI_SYSTEM</entry> - <entry>PHP 6.0.0 以降で利用可能。</entry> - </row> - <row> <entry>unicode.stream_encoding</entry> <entry>"UTF-8"</entry> <entry>PHP_INI_ALL</entry> http://cvs.php.net/viewvc.cgi/phpdoc-ja/appendices/history.xml?r1=1.18&r2=1.19&diff_format=u Index: phpdoc-ja/appendices/history.xml diff -u phpdoc-ja/appendices/history.xml:1.18 phpdoc-ja/appendices/history.xml:1.19 --- phpdoc-ja/appendices/history.xml:1.18 Fri Jun 22 14:31:32 2007 +++ phpdoc-ja/appendices/history.xml Fri Mar 13 03:59:04 2009 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.18 $ --> -<!-- EN-Revision: 1.28 Maintainer: hirokawa Status: ready --> +<!-- $Revision: 1.19 $ --> +<!-- EN-Revision: 1.29 Maintainer: hirokawa Status: ready --> <appendix xml:id="history" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>PHP の歴史と関連するプロジェクト</title> <para> @@ -48,6 +48,30 @@ PHP/FI 2.0は、その期間の多くをβ版として過ごした後、1997年の秋に 公式にリリースされました。その後すぐにPHP 3.0のα版が登場しました。 </para> + <para> + <example> + <title>PHP/FI のコード例</title> + <programlisting role="html"> +<![CDATA[ +<!--include /text/header.html--> + +<!--getenv HTTP_USER_AGENT--> +<!--ifsubstr $exec_result Mozilla--> + Hey, you are using Netscape!<p> +<!--endif--> + +<!--sql database select * from table where user='$username'--> +<!--ifless $numentries 1--> + Sorry, that record does not exist<p> +<!--endif exit--> + Welcome <!--$user-->!<p> + You have <!--$index:0--> credits left in your account.<p> + +<!--include /text/footer.html--> +]]> + </programlisting> + </example> + </para> </sect2> <sect2 xml:id="history.php3">
« previous php.doc.ja (#2434) next »