cvs: phpdoc-ja /reference/pdo/functions PDO-beginTransaction.xml PDO-construct.xml PDO-errorCode.xml PDO-errorInfo.xml PDO-exec.xml
PDO-getAttribute.xml PDO-lastInsertId.xml PDO-prepare.xml PDO-query.xml PDO-quote.xml PDO-rollBack.xml PDO-setAttribute.xml
PDOStatement-bindColumn.xml

shimooka Mon Jul 11 13:00:31 2005 EDT Modified files: /phpdoc-ja/reference/pdo/functions PDO-beginTransaction.xml PDO-construct.xml PDO-errorCode.xml PDO-errorInfo.xml PDO-exec.xml PDO-getAttribute.xml PDO-lastInsertId.xml PDO-prepare.xml PDO-query.xml PDO-quote.xml PDO-rollBack.xml PDO-setAttribute.xml PDOStatement-bindColumn.xml Log: translation updated

http://cvs.php.net/diff.php/phpdoc-ja/reference/pdo/functions/PDO-beginTransaction.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc-ja/reference/pdo/functions/PDO-beginTransaction.xml diff -u phpdoc-ja/reference/pdo/functions/PDO-beginTransaction.xml:1.1 phpdoc-ja/reference/pdo/functions/PDO-beginTransaction.xml:1.2 --- phpdoc-ja/reference/pdo/functions/PDO-beginTransaction.xml:1.1 Mon May 2 03:14:33 2005 +++ phpdoc-ja/reference/pdo/functions/PDO-beginTransaction.xml Mon Jul 11 13:00:28 2005 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8" ?> -<!-- $Revision: 1.1 $ --> -<!-- EN-Revision: 1.2 Maintainer: shimooka Status: ready --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.3 Maintainer: shimooka Status: ready --> <!-- Generated by xml_proto.php v2.1. Found in /scripts directory of phpdoc. --> <refentry id="function.PDO-beginTransaction"> <refnamediv> @@ -18,9 +18,10 @@ </methodsynopsis> &warn.experimental.func; <para> - オートコミットモードをオフにします。<function>PDO::commit</function> - か <function>PDO::rollback</function> をコールすると、 - トランザクションが終了し、オートコミットモードが元に戻ります。 + オートコミットモードをオフにします。オートコミットモードがオフの間、 + PDO オブジェクトを通じてデータベースに加えた変更は + <function>PDO::commit</function> + か <function>PDO::rollback</function> をコールするまでコミットされません。 </para> </refsect1> http://cvs.php.net/diff.php/phpdoc-ja/reference/pdo/functions/PDO-construct.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-ja/reference/pdo/functions/PDO-construct.xml diff -u phpdoc-ja/reference/pdo/functions/PDO-construct.xml:1.3 phpdoc-ja/reference/pdo/functions/PDO-construct.xml:1.4 --- phpdoc-ja/reference/pdo/functions/PDO-construct.xml:1.3 Sat Mar 12 21:25:07 2005 +++ phpdoc-ja/reference/pdo/functions/PDO-construct.xml Mon Jul 11 13:00:28 2005 @@ -1,11 +1,12 @@ <?xml version='1.0' encoding='utf-8'?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.11 Maintainer: hirokawa Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.12 Maintainer: shimooka Status: ready --> +<!-- CREDITS: hirokawa --> <refentry id="function.PDO-construct"> <refnamediv> <refname>PDO::__construct</refname> <refpurpose> - データベースへの接続を表すPDOインスタンスを生成する + データベースへの接続を表す PDO インスタンスを生成する </refpurpose> </refnamediv> <refsect1 role="description"> @@ -97,10 +98,28 @@ <term><constant>PDO_SQLITE</constant></term> <listitem> <para><userinput>sqlite:/path/to/database</userinput></para> - <para>データベースをメモリ上に作成する場合は、以下のようにしてください:</para> + <para>データベースをメモリ上に作成する場合は、 + 以下のようにしてください:</para> <para><userinput>sqlite::memory:</userinput></para> </listitem> </varlistentry> + <varlistentry> + <term><constant>sqlite (version 2)</constant></term> + <listitem> + <para><userinput>sqlite2:/path/to/database</userinput></para> + <para>データベースをメモリ上に作成する場合は、 + 以下のようにしてください:</para> + <para><userinput>sqlite2::memory:</userinput></para> + <note> + <para> + SQLite 2 PDO ドライバは、以前のバージョンの PHP + で作成した古い SQLite 2 データベースへのアクセス手段を提供します。 + この場合、より優れた機能やパフォーマンスのため、SQLite 3 + (PDO_SQLITE ドライバ) へマイグレーションする事が推奨されます。 + </para> + </note> + </listitem> + </varlistentry> </variablelist> </para> <para> @@ -169,14 +188,14 @@ </variablelist> </para> </refsect1> - + <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> 成功時にPDOオブジェクトを返します。 </para> </refsect1> - + <refsect1 role="exceptions"> &reftitle.exceptions; <para> @@ -185,7 +204,7 @@ PDOException を投げます。 </para> </refsect1> - + <refsect1 role="examples"> &reftitle.examples; <para> http://cvs.php.net/diff.php/phpdoc-ja/reference/pdo/functions/PDO-errorCode.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc-ja/reference/pdo/functions/PDO-errorCode.xml diff -u phpdoc-ja/reference/pdo/functions/PDO-errorCode.xml:1.1 phpdoc-ja/reference/pdo/functions/PDO-errorCode.xml:1.2 --- phpdoc-ja/reference/pdo/functions/PDO-errorCode.xml:1.1 Mon May 2 03:14:33 2005 +++ phpdoc-ja/reference/pdo/functions/PDO-errorCode.xml Mon Jul 11 13:00:28 2005 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8" ?> -<!-- $Revision: 1.1 $ --> -<!-- EN-Revision: 1.4 Maintainer: shimooka Status: ready --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.5 Maintainer: shimooka Status: ready --> <!-- Generated by xml_proto.php v2.1. Found in /scripts directory of phpdoc. --> <refentry id="function.PDO-errorCode"> <refnamediv> @@ -22,8 +22,15 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - SQLSTATE を返します。これは、ANSI SQL 標準で定義された英数 5 - 文字の ID です。 + SQLSTATE を返します。これは、ANSI SQL-92 標準で定義された英数 5 + 文字の ID です。簡潔に言えば、SQLSTATE は 2文字のクラス値の後に + 3 文字のサブクラス値が続きます。クラス値 01 はワーニングを表し、 + 戻り値のコード SQL_SUCCESS_WITH_INFO を伴います。 + クラス 'IM' を除く '01' 以外のクラス値はエラーを表します。 + クラス 'IM' は PDO 自身の実装 (もしくは ODBC ドライバを使用している場合は + ODBC かも知れません) に由来するワーニングやエラーに固有の値です。 + あらゆるクラスでのサブクラス値 '000' は SQLSTATE + に対するサブクラスがない事を示しています。 </para> <para> <function>PDO::errorCode</function> はデータベースハンドラに @@ -31,7 +38,7 @@ もし <function>PDO::prepare</function> や <function>PDO::query</function> を通して PDOStatement オブジェクトを生成し、 文でエラーが発生した場合、<function>PDO::errorCode</function> - は <literal>PDO_ERR_NONE</literal> を返します。 + はエラーを反映しません。 特定の文ハンドラに対して実行された操作についてのエラーコードを返すには <function>PDOStatement::errorCode</function> をコールしなければなりません。 http://cvs.php.net/diff.php/phpdoc-ja/reference/pdo/functions/PDO-errorInfo.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc-ja/reference/pdo/functions/PDO-errorInfo.xml diff -u phpdoc-ja/reference/pdo/functions/PDO-errorInfo.xml:1.1 phpdoc-ja/reference/pdo/functions/PDO-errorInfo.xml:1.2 --- phpdoc-ja/reference/pdo/functions/PDO-errorInfo.xml:1.1 Mon May 2 03:14:33 2005 +++ phpdoc-ja/reference/pdo/functions/PDO-errorInfo.xml Mon Jul 11 13:00:28 2005 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8" ?> -<!-- $Revision: 1.1 $ --> -<!-- EN-Revision: 1.5 Maintainer: shimooka Status: ready --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.6 Maintainer: shimooka Status: ready --> <!-- Generated by xml_proto.php v2.1. Found in /scripts directory of phpdoc. --> <refentry id="function.PDO-errorInfo"> <refnamediv> @@ -58,8 +58,7 @@ もし <function>PDO::prepare</function> や <function>PDO::query</function> を通して PDOStatement オブジェクトを生成し、 文でエラーが発生した場合、<function>PDO::errorInfo</function> - は返される配列の先頭の要素にエラーコード - <literal>PDO_ERR_NONE</literal> を挿入します。 + はそのエラーを反映しません。 特定の文ハンドラに対して実行された操作についてのエラーコードを返すには <function>PDOStatement::errorInfo</function> をコールしなければなりません。 http://cvs.php.net/diff.php/phpdoc-ja/reference/pdo/functions/PDO-exec.xml?r1=1.3&r2=1.4&ty=u Index: phpdoc-ja/reference/pdo/functions/PDO-exec.xml diff -u phpdoc-ja/reference/pdo/functions/PDO-exec.xml:1.3 phpdoc-ja/reference/pdo/functions/PDO-exec.xml:1.4 --- phpdoc-ja/reference/pdo/functions/PDO-exec.xml:1.3 Thu Jun 2 12:35:08 2005 +++ phpdoc-ja/reference/pdo/functions/PDO-exec.xml Mon Jul 11 13:00:28 2005 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8" ?> -<!-- $Revision: 1.3 $ --> -<!-- EN-Revision: 1.6 Maintainer: shimooka Status: ready --> +<!-- $Revision: 1.4 $ --> +<!-- EN-Revision: 1.7 Maintainer: shimooka Status: ready --> <!-- Generated by xml_proto.php v2.1. Found in /scripts directory of phpdoc. --> <refentry id="function.PDO-exec"> <refnamediv> @@ -20,13 +20,13 @@ <para> <function>PDO::exec</function> は、一度の関数コールで SQL - 文を準備、実行し、文によって作用した行数を返します。 + 文を実行し、文によって作用した行数を返します。 </para> <para> <function>PDO::exec</function> は SELECT 文からは結果を返しません。 プログラム中で一度だけ発行が必要になる SELECT 文に対しては、 <function>PDO::query</function> の発行を検討してください。 - 複数回発行が必要な SELECT 文については、<function>PDO::prepare</function> + 複数回発行が必要な文については、<function>PDO::prepare</function> による PDOStatement オブジェクトの準備と <function>PDOStatement::execute</function> による文の発行を行ってください。 </para> @@ -89,7 +89,6 @@ $count = $dbh->exec("DELETE FROM fruit WHERE colour = 'red'"); /* 削除された行数を返す */ -print("Return number of rows that were deleted:\n"); print("Deleted $count rows.\n"); ?> ]]> @@ -97,7 +96,6 @@ &example.outputs; <screen> <![CDATA[ -Return number of rows that were deleted: Deleted 1 rows. ]]> </screen> http://cvs.php.net/diff.php/phpdoc-ja/reference/pdo/functions/PDO-getAttribute.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-ja/reference/pdo/functions/PDO-getAttribute.xml diff -u phpdoc-ja/reference/pdo/functions/PDO-getAttribute.xml:1.2 phpdoc-ja/reference/pdo/functions/PDO-getAttribute.xml:1.3 --- phpdoc-ja/reference/pdo/functions/PDO-getAttribute.xml:1.2 Thu Jun 2 12:35:08 2005 +++ phpdoc-ja/reference/pdo/functions/PDO-getAttribute.xml Mon Jul 11 13:00:28 2005 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8" ?> -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.4 Maintainer: shimooka Status: ready --> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.5 Maintainer: shimooka Status: ready --> <!-- Generated by xml_proto.php v2.2. Found in /scripts directory of phpdoc. --> <refentry id="function.PDO-getAttribute"> <refnamediv> @@ -25,7 +25,7 @@ </para> <para> - いくつかのデータベースは、 + いくつかのデータベースもしくはドライバは、 データベース接続の属性の全てのをサポートしていないかも知れないことに 注意してください。 </para> @@ -47,6 +47,7 @@ <member><literal>PDO_ATTR_CASE</literal></member> <member><literal>PDO_ATTR_CLIENT_VERSION</literal></member> <member><literal>PDO_ATTR_CONNECTION_STATUS</literal></member> + <member><literal>PDO_ATTR_DRIVER_NAME</literal></member> <member><literal>PDO_ATTR_ERRMODE</literal></member> <member><literal>PDO_ATTR_ORACLE_NULLS</literal></member> <member><literal>PDO_ATTR_PERSISTENT</literal></member> http://cvs.php.net/diff.php/phpdoc-ja/reference/pdo/functions/PDO-lastInsertId.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-ja/reference/pdo/functions/PDO-lastInsertId.xml diff -u phpdoc-ja/reference/pdo/functions/PDO-lastInsertId.xml:1.2 phpdoc-ja/reference/pdo/functions/PDO-lastInsertId.xml:1.3 --- phpdoc-ja/reference/pdo/functions/PDO-lastInsertId.xml:1.2 Sat Jul 9 22:58:53 2005 +++ phpdoc-ja/reference/pdo/functions/PDO-lastInsertId.xml Mon Jul 11 13:00:28 2005 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8" ?> -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.7 Maintainer: shimooka Status: ready --> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.8 Maintainer: shimooka Status: ready --> <!-- Generated by xml_proto.php v2.1. Found in /scripts directory of phpdoc. --> <refentry id="function.PDO-lastInsertId"> <refnamediv> @@ -21,11 +21,14 @@ <para> 最後に挿入された行の ID、 あるいはシーケンスオブジェクトから次の値をを返します。 + これは、構成しているドライバに依存します。 </para> <note> <para> - データベースサーバの実装が異なりますので、 - このメソッドは常に意味のある結果を返さないかも知れません。 + このメソッドは、異なる PDO ドライバ間で意味のあるもしくは + 一貫性のある結果を返さないかも知れません。 + 構成しているデータベースが自動インクリメントフィールド、 + もしくはシーケンスの概念をサポートしていないかも知れないためです。 </para> </note> </refsect1> http://cvs.php.net/diff.php/phpdoc-ja/reference/pdo/functions/PDO-prepare.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-ja/reference/pdo/functions/PDO-prepare.xml diff -u phpdoc-ja/reference/pdo/functions/PDO-prepare.xml:1.2 phpdoc-ja/reference/pdo/functions/PDO-prepare.xml:1.3 --- phpdoc-ja/reference/pdo/functions/PDO-prepare.xml:1.2 Thu May 5 00:33:04 2005 +++ phpdoc-ja/reference/pdo/functions/PDO-prepare.xml Mon Jul 11 13:00:28 2005 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8" ?> -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.6 Maintainer: shimooka Status: ready --> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.7 Maintainer: shimooka Status: ready --> <!-- Generated by xml_proto.php v2.1. Found in /scripts directory of phpdoc. --> <refentry id="function.PDO-prepare"> <refnamediv> @@ -21,18 +21,29 @@ <para> <function>PDOStatement::execute</function> メソッドによって実行される SQL 文を準備します。 - SQL 文は、文が実行されるときに実際の値に置き換えられる 0 個もしくはそれ以上の名前 (:name) もしくは疑問符 (?) パラメータマークを含むことができます。 + 名前と疑問符パラメータを同一 SQL 文中で使用することはできません。 + どちらか一方か、他のパラメータ形式を使用してください。 </para> <para> 異なるパラメータを用いて複数回実行されるような文に対し <function>PDO::prepare</function> と - <function>PDOStatement::execute</function> をコールすることは、 - アプリケーションのパフォーマンスを最適化し、 + <function>PDOStatement::execute</function> をコールすることで、 + ドライバがクライアントまたはサーバ側にクエリプランやメタ情報を + キャッシュさせるよう調整するため、 + アプリケーションのパフォーマンスを最適化します。また、 + パラメータに手動でクオートする必要がなくなるので SQL インジェクション攻撃から保護する助けになります。 </para> + <para> + PDO は元々この機能をサポートしていないドライバに対して + プリペアドステートメントとバインドパラメータをエミュレートします。 + このため、ある形式をサポートしているがその他の形式をサポートしていない + ドライバの場合、名前もしくは疑問符形式のパラメータを他の適当な値に + 書き換えることも可能です。 + </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; @@ -57,7 +68,9 @@ 通常、スクロール可能なカーソルを要求するために <literal>PDO_ATTR_CURSOR</literal> に <literal>PDO_CURSOR_SCROLL</literal> - をセットする場合に使用するでしょう。 + を設定する場合に使用することになるでしょう。 + いくつかのドライバには、準備する際に利用可能なドライバ固有の + オプションがあります。 </para> </listitem> </varlistentry> http://cvs.php.net/diff.php/phpdoc-ja/reference/pdo/functions/PDO-query.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc-ja/reference/pdo/functions/PDO-query.xml diff -u phpdoc-ja/reference/pdo/functions/PDO-query.xml:1.1 phpdoc-ja/reference/pdo/functions/PDO-query.xml:1.2 --- phpdoc-ja/reference/pdo/functions/PDO-query.xml:1.1 Sun Mar 13 02:27:49 2005 +++ phpdoc-ja/reference/pdo/functions/PDO-query.xml Mon Jul 11 13:00:28 2005 @@ -1,6 +1,7 @@ <?xml version='1.0' encoding='utf-8'?> -<!-- $Revision: 1.1 $ --> -<!-- EN-Revision: 1.2 Maintainer: hirokawa Status: ready --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.3 Maintainer: shimooka Status: ready --> +<!-- CREDITS: hirokawa --> <refentry id="function.PDO-query"> <refnamediv> <refname>PDO::query</refname> @@ -14,19 +15,19 @@ <type>object</type><methodname>PDO::query</methodname> <methodparam><type>string</type><parameter>statement</parameter></methodparam> </methodsynopsis> - + &warn.experimental.func; - + <para> <function>PDO::query</function> は、一回の関数コールの中で - SQLステートメントを準備した後に実行し、このステートメントにより返された - 結果セット(ある場合)をPDOStatementオブジェクトとして返します。 + SQL ステートメントを実行し、このステートメントにより返された + 結果セット (ある場合) を PDOStatement オブジェクトとして返します。 </para> <para> - 複数回発行する必要があるSELECTステートメントの場合、 - <function>PDO::prepare</function>でPDOStatementステートメントを準備し、 - <function>PDOStatement::execute</function>でそのステートメントを - 発行してください。 + 複数回発行する必要があるステートメントの場合、 + <function>PDO::prepare</function> で PDOStatement ステートメントを準備し、 + <function>PDOStatement::execute</function> でそのステートメントを + 複数回発行する方がより良いパフォーマンスを得られると実感するでしょう。 </para> </refsect1> @@ -38,7 +39,7 @@ <term><parameter>statement</parameter></term> <listitem> <para> - 準備、発行するSQLステートメント。 + 準備、発行する SQL ステートメント。 </para> </listitem> </varlistentry> http://cvs.php.net/diff.php/phpdoc-ja/reference/pdo/functions/PDO-quote.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc-ja/reference/pdo/functions/PDO-quote.xml diff -u phpdoc-ja/reference/pdo/functions/PDO-quote.xml:1.1 phpdoc-ja/reference/pdo/functions/PDO-quote.xml:1.2 --- phpdoc-ja/reference/pdo/functions/PDO-quote.xml:1.1 Mon May 2 03:14:33 2005 +++ phpdoc-ja/reference/pdo/functions/PDO-quote.xml Mon Jul 11 13:00:28 2005 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8" ?> -<!-- $Revision: 1.1 $ --> -<!-- EN-Revision: 1.1 Maintainer: shimooka Status: ready --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.2 Maintainer: shimooka Status: ready --> <!-- Generated by xml_proto.php v2.2. Found in /scripts directory of phpdoc. --> <refentry id="function.PDO-quote"> <refnamediv> @@ -21,15 +21,17 @@ <para> <function>PDO::quote</function> は入力文字列のまわりに引用符を付け、 - 入力文字列にあるシングルクオートをエスケープします。 - 入力文字列をクオートすることは、一般的に SQL - インジェクション攻撃を防ぐという意味を持ちます。 - しかしながら、より安全なアプローチは - 入力値に対して名前付けされたパラメータやプレースホルダを使用する - プリペアドステートメントを使用することです。 + 入力文字列にあるシングルクオートをエスケープします。その場合、 + 構成しているドライバに適したクオート形式が使用されます。 + </para> + <para> + この関数を SQL の構築に使用する場合、代わりにプリペアドステートメントと + バインドパラメータを使用することが推奨されます。これはより便利なだけでなく、 + しばしばより高速なためです。 </para> <para> 全ての PDO ドライバがこのメソッドを実装しているわけではありません。 + 代わりにプリペアドステートメントを使用することを検討してください。 </para> </refsect1> <refsect1 role="parameters"> @@ -61,6 +63,8 @@ &reftitle.returnvalues; <para> 理論上安全なクオートされた SQL 文の文字列を返します。 + ドライバがこの方法での引用符付けをサポートしていない場合は + &false; を返します。 </para> </refsect1> http://cvs.php.net/diff.php/phpdoc-ja/reference/pdo/functions/PDO-rollBack.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc-ja/reference/pdo/functions/PDO-rollBack.xml diff -u phpdoc-ja/reference/pdo/functions/PDO-rollBack.xml:1.1 phpdoc-ja/reference/pdo/functions/PDO-rollBack.xml:1.2 --- phpdoc-ja/reference/pdo/functions/PDO-rollBack.xml:1.1 Mon May 2 03:14:33 2005 +++ phpdoc-ja/reference/pdo/functions/PDO-rollBack.xml Mon Jul 11 13:00:28 2005 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8" ?> -<!-- $Revision: 1.1 $ --> -<!-- EN-Revision: 1.4 Maintainer: shimooka Status: ready --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.5 Maintainer: shimooka Status: ready --> <!-- Generated by xml_proto.php v2.1. Found in /scripts directory of phpdoc. --> <refentry id="function.PDO-rollBack"> <refnamediv> @@ -19,14 +19,15 @@ &warn.experimental.func; <para> - トランザクションをサポートするデータベースに対して実行すると、 - <function>PDO::rollBack</function> は進行中の全ての処理をロールバックし、 - 接続状態をオートコミットモードに戻します。 + <function>PDO::beginTransaction</function> によって開始された + 現在のトランザクションをロールバックします + 有効なトランザクションがない場合にこのメソッドをコールすると + エラーになります。 </para> <para> - <function>PDO::rollBack</function> が効果を発揮する前に、 - 接続状態を手動コミットモードに設定するために - <function>PDO::beginTransaction</function> を使用しなければなりません。 + データベースがオートコミットモードに設定されている場合、 + この関数はトランザクションをロールバックした後に + オートコミットモードを元に戻します。 </para> </refsect1> http://cvs.php.net/diff.php/phpdoc-ja/reference/pdo/functions/PDO-setAttribute.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc-ja/reference/pdo/functions/PDO-setAttribute.xml diff -u phpdoc-ja/reference/pdo/functions/PDO-setAttribute.xml:1.1 phpdoc-ja/reference/pdo/functions/PDO-setAttribute.xml:1.2 --- phpdoc-ja/reference/pdo/functions/PDO-setAttribute.xml:1.1 Mon May 2 03:14:33 2005 +++ phpdoc-ja/reference/pdo/functions/PDO-setAttribute.xml Mon Jul 11 13:00:28 2005 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8" ?> -<!-- $Revision: 1.1 $ --> -<!-- EN-Revision: 1.2 Maintainer: shimooka Status: ready --> +<!-- $Revision: 1.2 $ --> +<!-- EN-Revision: 1.3 Maintainer: shimooka Status: ready --> <!-- Generated by xml_proto.php v2.1. Found in /scripts directory of phpdoc. --> <refentry id="function.PDO-setAttribute"> <refnamediv> @@ -19,8 +19,9 @@ &warn.experimental.func; <para> - データベース接続の属性を設定します。通常の PDO 接続の属性は、 - 次の項目を含みます。 + データベースハンドルの属性を設定します。 + 利用可能な通常の属性は以下の一覧の通りです。いくつかのドライバでは、 + ドライバ固有の属性を使用することが可能です。 <itemizedlist> <listitem><para> <literal>PDO_ATTR_CASE</literal>: 強制的にカラム名を指定したケースにする @@ -38,7 +39,6 @@ </itemizedlist> </para></listitem> </itemizedlist> - PDO ドライバは、これ以外にドライバ固有の属性を定義しているかも知れません。 </para> </refsect1> </refentry> http://cvs.php.net/diff.php/phpdoc-ja/reference/pdo/functions/PDOStatement-bindColumn.xml?r1=1.2&r2=1.3&ty=u Index: phpdoc-ja/reference/pdo/functions/PDOStatement-bindColumn.xml diff -u phpdoc-ja/reference/pdo/functions/PDOStatement-bindColumn.xml:1.2 phpdoc-ja/reference/pdo/functions/PDOStatement-bindColumn.xml:1.3 --- phpdoc-ja/reference/pdo/functions/PDOStatement-bindColumn.xml:1.2 Sun May 29 07:50:16 2005 +++ phpdoc-ja/reference/pdo/functions/PDOStatement-bindColumn.xml Mon Jul 11 13:00:28 2005 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8" ?> -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.5 Maintainer: shimooka Status: ready --> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.6 Maintainer: shimooka Status: ready --> <!-- Generated by xml_proto.php v2.1. Found in /scripts directory of phpdoc. --> <refentry id="function.PDOStatement-bindColumn"> <refnamediv> @@ -16,20 +16,25 @@ <methodparam><type>mixed</type><parameter>column</parameter></methodparam> <methodparam><type>mixed</type><parameter role="reference">param</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>type</parameter></methodparam> - <methodparam choice="opt"><type>int</type><parameter>maxlen</parameter></methodparam> - <methodparam choice="opt"><type>mixed</type><parameter>driver_options</parameter></methodparam> </methodsynopsis> &warn.experimental.func; <para> - それぞれの行フェッチで、<parameter>param</parameter> - は一致するカラムの値を含みます。 - <parameter>column</parameter> は 1 から始まるカラムのオフセット、 - もしくはカラム名です。 - ポータビリティを最大化するため、<function>PDOStatement::execute</function> - をコールする前にこの関数をコールしないでください。 + <function>PDOStatement::bindColumn</function> は、 + クエリからの結果セット中にあるカラムにバインドされた特定の値を + 取得するための準備をします。 + <function>PDOStatement::fetch</function> もしくは + <function>PDOStatement::fetchAll</function> + がコールされる度に、カラムにバインドされた全ての変数は更新されます。 </para> - + <note> + <para> + カラムに関する情報はステートメントが実行されるまで常に + PDO から利用できないため、移植可能なアプリケーションでは + <function>PDO::execute</function> の <emphasis>後に</emphasis> + この関数をコールするようにしてください。 + </para> + </note> </refsect1> <refsect1 role="parameters"> @@ -41,6 +46,9 @@ <listitem> <para> 結果セット中のカラム番号 (1 から始まる) を指定します。 + カラム名を使用する場合、 + ドライバによって返されるカラムの大文字小文字が一致する必要が + あることをご承知おきください。 </para> </listitem> </varlistentry> @@ -60,22 +68,6 @@ </para> </listitem> </varlistentry> - <varlistentry> - <term><parameter>maxlen</parameter></term> - <listitem> - <para> - パラメータの最大長を指定します。 - </para> - </listitem> - </varlistentry> - <varlistentry> - <term><parameter>driver_options</parameter></term> - <listitem> - <para> - - </para> - </listitem> - </varlistentry> </variablelist> </para> </refsect1> @@ -102,15 +94,12 @@ $stmt = $dbh->prepare($sql); $stmt->execute(); - /* 明示的なデータ型とデータ長を用い、カラム番号によってバインドする */ - /* Bind by column number with an explicit data type & length */ - $stmt->bindColumn(1, $name, PDO_PARAM_STR, 64); - - /* デフォルトのデータ型とデータ長を用い、カラム番号によってバインドする */ + /* カラム番号によってバインドする */ + $stmt->bindColumn(1, $name); $stmt->bindColumn(2, $colour); - /* デフォルトのデータ型とデータ長を用い、カラム名によってバインドする */ - $stmt->bindColumn('CALORIES', $cals); + /* カラム名によってバインドする */ + $stmt->bindColumn('calories', $cals); while ($row = $stmt->fetch(PDO_FETCH_BOUND)) { $data = $name . "\t" . $colour . "\t" . $cals . "\n";