cvs: phpdoc-ja /reference/mongo/functions mongo-gridfs-find.xml mongo-gridfs-init.xml mongo-gridfs-list.xml mongo-gridfs-store.xml mongo-query.xml
mongo-remove.xml mongo-update.xml /reference/mysqli persistconns.xml /reference/mysqli/mysqli_result fetch-all.xml /reference/pcre
pattern.differences.xml

takagi Wed Mar 4 03:29:49 2009 UTC Added files: /phpdoc-ja/reference/pcre pattern.differences.xml /phpdoc-ja/reference/mysqli/mysqli_result fetch-all.xml /phpdoc-ja/reference/mysqli persistconns.xml /phpdoc-ja/reference/mongo/functions mongo-update.xml mongo-remove.xml mongo-query.xml mongo-gridfs-store.xml mongo-gridfs-list.xml mongo-gridfs-init.xml mongo-gridfs-find.xml Log: sync with en.

http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/pcre/pattern.differences.xml?view=markup&rev=1.1 Index: phpdoc-ja/reference/pcre/pattern.differences.xml +++ phpdoc-ja/reference/pcre/pattern.differences.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.1 Maintainer: takagi Status: ready --> <!-- CREDITS: hirokawa,haruki --> <article xml:id="reference.pcre.pattern.differences" xmlns="http://docbook.org/ns/docbook"> <title>Perl との違い</title> <titleabbrev>Perl とは異なる点</titleabbrev> <para> Perl 5.005 との違いについて以下に説明します。 <orderedlist> <listitem> <simpara> デフォルトでは、空白文字は C ライブラリ関数 isspace() が認識する文字となります。PCRE を別の文字型テーブルを用いて コンパイルすることも可能です。通常、isspace() はスペース、改ページ、 改行、復帰、水平タブ、垂直タブにマッチします。 Perl 5 では、現在、 垂直タブが空白文字として扱われていません。 Perl ドキュメントには \v というエスケープが記載されていましたが、実際は認識されていませんでした。 ただし、垂直タブ文字は少なくとも 5.002 までは空白文字として 処理されていました。 5.004 および 5.005 では、\s にマッチしなくなっています。 </simpara> </listitem> <listitem> <simpara> PCRE では、先読み言明に量指定子を指定できません。Perl では可能ですが、思ったような動作を意味しないかもしれません。 例えば、(?!a){3} は、続く 3 文字が "a" でないことの言明ではありません。 この指定は、次の 1 文字が "a" ではないことを 3 回言明するだけです。 </simpara> </listitem> <listitem> <simpara> 否定の先読み言明の中に記述したキャプチャ用サブパターンは カウントされますが、対応するオフセットにそのエントリは セットされません。 Perlでは、言明のマッチングに失敗する前に マッチしたパターンからその変数を設定しますが、それが行われるのは、 否定の先読み言明中の選択肢が 1 つだけの場合のみです。 </simpara> </listitem> <listitem> <simpara> ヌル文字は、検索対象文字列においては使用できますが、 パターン文字列内では使用できません。これは、パターン文字列が 0 を終端とする通常の C 文字列として渡されるためです。パターン中では、 エスケープシーケンス "\x00" を使ってヌル文字を表すことができます。 </simpara> </listitem> <listitem> <simpara> 次の Perl エスケープシーケンスはサポートされせん。 \l, \u, \L, \U, \E, \Q 。 これらのエスケープシーケンスは、Perl のパターンマッチエンジン内 ではなく、文字列処理の部分で実装されているためです。 </simpara> </listitem> <listitem> <simpara> Perl の \G 言明は、単一のパターンマッチに対しては意味がなく、 サポートされません。 </simpara> </listitem> <listitem> <simpara> 当然ながら、PCRE により、(?{code}) 構文および (??{code}) 構文はサポートされません。しかし、再帰的なパターンはサポートしています。 </simpara> </listitem> <listitem> <simpara> Perl 5.005_02 では、パターンの一部を繰り返すと、キャプチャ文字列の セットに関して奇妙な動作をすることがあるようです。例えば、"aba" を パターン /^(a(b)?)+$/ に対してマッチングを行うと、 $2 には値 "b" が設定されますが、"aabbaa" を /^(aa(bb)?)+$/ に対して マッチングを行うと、$2 はセットされません。 しかし、パターンを /^(aa(b(b))?)+$/ に変えると、 $2 (および $3) はセットされます。 Perl 5.004 では、どちらの場合も $2 はセットされます。 PCRE の場合も、 どちらの場合でもセットされます。将来的に Perl が矛盾のない状態に 変更された場合は、PCRE も追従する可能性があります。 </simpara> </listitem> <listitem> <simpara> 他の未解決の食い違いとして、パターン /^(a)?(?(1)a|b)+$/ は、 Perl 5.005_02 では文字列 "a" にマッチしますが、PCRE ではマッチしない ということがあります。しかし、Perl と PCRE のいずれでも、/^(a)?a/ で "a" をマッチした場合は $1 が未定義のままとなります。 </simpara> </listitem> <listitem> <para> PCRE では、Perl の正規表現の機能よりさらに拡張された機能を使うことができます。 <orderedlist> <listitem> <simpara> 戻り読み言明は、固定長の文字列にマッチする必要がありますが、 このとき、戻り読み言明内の選択肢は、それぞれ異なる長さの文字列に マッチするパターンとしても問題ありません。Perl 5.005 では すべての選択肢が同じ長さである必要があります。 </simpara> </listitem> <listitem> <simpara> <link linkend="reference.pcre.pattern.modifiers">PCRE_DOLLAR_ENDONLY</link> が設定され <link linkend="reference.pcre.pattern.modifiers">PCRE_MULTILINE</link> が設定されていない場合、メタ文字 $ は文字列の終端にのみ マッチします。 </simpara> </listitem> <listitem> <simpara> <link linkend="reference.pcre.pattern.modifiers">PCRE_EXTRA</link> を設定すると、バックスラッシュの後に意味がない文字が続くと エラーとなります。 </simpara> </listitem> <listitem> <simpara> <link linkend="reference.pcre.pattern.modifiers">PCRE_UNGREEDY</link> を設定すると、量指定子の貪欲さが反転します。つまり、量指定子は、 デフォルトで貪欲でなく、疑問符を後ろに付けてはじめて 貪欲になるようになります。 </simpara> </listitem> </orderedlist> </para> </listitem> </orderedlist> </para> </article> <!-- 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/viewvc.cgi/phpdoc-ja/reference/mysqli/mysqli_result/fetch-all.xml?view=markup&rev=1.1 Index: phpdoc-ja/reference/mysqli/mysqli_result/fetch-all.xml +++ phpdoc-ja/reference/mysqli/mysqli_result/fetch-all.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: takagi Status: ready --> <refentry xml:id="mysqli-result.fetch-all" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>mysqli_result::fetch_all</refname> <refname>mysqli_fetch_all</refname> <refpurpose>結果のすべての行を連想配列・数値添字配列あるいはその両方の形式で取得する</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <para>オブジェクト指向型（メソッド）:</para> <methodsynopsis> <type>mixed</type><methodname>mysqli_result::fetch_all</methodname> <methodparam choice='opt'><type>int</type><parameter>resulttype</parameter></methodparam> </methodsynopsis> <para>手続き型:</para> <methodsynopsis> <type>mixed</type><methodname>mysqli_fetch_all</methodname> <methodparam><type>mysqli_result</type><parameter>result</parameter></methodparam> <methodparam choice='opt'><type>int</type><parameter>resulttype</parameter></methodparam> </methodsynopsis> <para> &mysqli.available.mysqlnd; </para> <para> <function>mysqli_fetch_all</function> は、 すべての結果の行を取得してその結果セットを連想配列・数値添字配列あるいはその両方で返します。 </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> &mysqli.result.description; <varlistentry> <term><parameter>resulttype</parameter></term> <listitem> <para> このオプションは、 結果の行データから返す配列の型を指定します。ここで指定可能な値は 定数 <constant>MYSQLI_ASSOC</constant>、 <constant>MYSQLI_NUM</constant> あるいは <constant>MYSQLI_BOTH</constant>. のいずれかです。デフォルトは <constant>MYSQLI_NUM</constant> です。 </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> 結果の行を含む連想配列あるいは数値添字配列の配列を返します。 </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>mysqli_fetch_array</function></member> <member><function>mysqli_query</function></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/mysqli/persistconns.xml?view=markup&rev=1.1 Index: phpdoc-ja/reference/mysqli/persistconns.xml +++ phpdoc-ja/reference/mysqli/persistconns.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: takagi Status: ready --> <chapter xml:id="mysqli.persistconns" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>mysqli 拡張モジュールでの持続的接続</title> <para> PHP 5.3 以降、<literal>mysqli</literal> 拡張モジュールで持続的接続がサポートされるようになりました。 PDO MYSQL や ext/mysql では以前からサポートされていました。 持続的接続とは、クライアントプロセスとデータベースとの間の接続を 何度も作っては破棄するかわりにクライアントプロセス側で再利用しようというものです。 これにより、必要なときに毎回新規接続を作成するというオーバーヘッドが軽減でき、 未使用の接続はキャッシュされて再利用できるようになります。 </para> <para> 持続的接続の問題は、予期せぬ状態でクライアント側に残ってしまう可能性があるということです。 たとえば、テーブルロックを行った状態でクライアントが突然終了してしまったとしましょう。 新しいクライアントプロセスがこの持続的接続を使用する際には、 <quote>そのまま</quote> の状態でこれを使うことになります。 新しいクライアントプロセスがこの持続的接続をきちんと使うためには事前になんらかの後始末が必要となります。 これはプログラマにとっては面倒な作業です。 </para> <para> しかし、<literal>mysqli</literal> 拡張モジュールの持続的接続には後始末を行うコードが組み込まれています。 <literal>mysqli</literal> は、以下のような後始末を行います。 </para> <itemizedlist> <listitem> <para> アクティブなトランザクションのロールバック </para> </listitem> <listitem> <para> 一時テーブルを閉じて drop </para> </listitem> <listitem> <para> テーブルロックの解除 </para> </listitem> <listitem> <para> セッション変数の初期化 </para> </listitem> <listitem> <para> プリペアドステートメントを閉じる (PHP では常に発生) </para> </listitem> <listitem> <para> ハンドラを閉じる </para> </listitem> <listitem> <para> <function>GET_LOCK</function> で取得したロックの開放 </para> </listitem> </itemizedlist> <para> これにより、コネクションプールから取得する接続がクリーンな状態であることが確実になり、 そのままクライアントプロセスで使用できるようになります。 </para> <para> <literal>mysqli</literal> 拡張モジュールのクリーンアップ処理は、 C の API 関数 <literal>mysql_change_user()</literal> を自動的にコールすることで行っています。 </para> <para> しかし、自動クリーンアップ処理にはいい面もあれば悪い面もあります。 利点としては、プログラマがクリーンアップのコードを書くことを気にせずにすむということがあります。 自動的にコールされるからです。しかし、多少動作が遅くなるという <emphasis>可能性</emphasis> もあります。 接続がコネクションプールに戻される際に毎回クリーンアップが必要となるからです。 </para> <para> 自動クリーンアップのコードを無効にしたい場合は、 <constant>MYSQLI_NO_CHANGE_USER_ON_PCONNECT</constant> を define して PHP をコンパイルします。 </para> <note> <para> <literal>mysqli</literal> 拡張モジュールは、 MySQL Native Drive あるいは MySQL Client Library のどちらを使っている場合でも持続的接続をサポートします。 </para> </note> </chapter> <!-- 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/viewvc.cgi/phpdoc-ja/reference/mongo/functions/mongo-update.xml?view=markup&rev=1.1 Index: phpdoc-ja/reference/mongo/functions/mongo-update.xml +++ phpdoc-ja/reference/mongo/functions/mongo-update.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: takagi Status: ready --> <refentry xml:id="function.mongo-update" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>mongo_update</refname> <refpurpose>データベースコレクション内のオブジェクトを更新する</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>mongo_update</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> <methodparam><type>string</type><parameter>ns</parameter></methodparam> <methodparam><type>array</type><parameter>query</parameter></methodparam> <methodparam><type>array</type><parameter>newobj</parameter></methodparam> <methodparam><type>bool</type><parameter>upsert</parameter></methodparam> </methodsynopsis> <para> マッチするオブジェクトを削除し、それを新しい形式にマッチするよう変更し、 データベースに再度保存します。マッチするオブジェクトがなくかつ upsert が設定されていた場合は、新しいオブジェクトをデータベースに挿入します。 </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>connection</parameter></term> <listitem> <para> 使用するデータベース接続。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>ns</parameter></term> <listitem> <para> データベースおよびコレクションの名前。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>query</parameter></term> <listitem> <para> 問い合わせるオブジェクト。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>newobj</parameter></term> <listitem> <para> マッチしたものを置き換えるオブジェクト。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>upsert</parameter></term> <listitem> <para> クエリが返すオブジェクトがなかった場合に newobj をコレクションに挿入するかどうか。 </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> 更新が成功したかどうかを返します。 </para> </refsect1> <refsect1 role="errors"> &reftitle.errors; <para> <!-- When does this function issue E_* level errors, and/or throw exceptions. --> </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>mongo_update</function> の例</title> <para> この例は、既存のオブジェクトを更新する方法を示します。 </para> <programlisting role="php"> <![CDATA[ <?php $query = array("x" => "y"); $newobj = array("x" => "z"); $conn = mongo_connect("localhost", true); if (!$conn) { die("Could not connect."); } $ok = mongo_update($conn, "foo.bar", $query, $newobj, false); if( $ok ) { echo "updated"; } ?> ]]> </programlisting> &example.outputs.similar; <screen> <![CDATA[ updated ]]> </screen> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>mongo_insert</function></member> <member><function>mongo_remove</function></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/mongo/functions/mongo-remove.xml?view=markup&rev=1.1 Index: phpdoc-ja/reference/mongo/functions/mongo-remove.xml +++ phpdoc-ja/reference/mongo/functions/mongo-remove.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: takagi Status: ready --> <refentry xml:id="function.mongo-remove" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>mongo_remove</refname> <refpurpose>ドキュメントをデータベースコレクションから削除する</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>bool</type><methodname>mongo_remove</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> <methodparam><type>string</type><parameter>ns</parameter></methodparam> <methodparam><type>array</type><parameter>query</parameter></methodparam> <methodparam><type>bool</type><parameter>justOne</parameter></methodparam> </methodsynopsis> <para> 条件に基づいて、データベースコレクションからオブジェクトを削除します。 </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>connection</parameter></term> <listitem> <para> 使用するデータベース接続。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>ns</parameter></term> <listitem> <para> データベースおよびコレクションの名前。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>query</parameter></term> <listitem> <para> 削除するオブジェクトの条件の配列。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>justOne</parameter></term> <listitem> <para> 条件にマッチするオブジェクトのうちひとつだけを削除するのかどうか。 </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> 削除に成功したかどうかを返します。 </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>mongo_remove</function> の例</title> <para> この例では、Doug という名前のすべてのユーザを www データベースの users コレクションから削除します。 </para> <programlisting role="php"> <![CDATA[ <?php $rquery = array("username" => "Doug"); $conn = mongo_connect("localhost", true); if (!$conn) { die("Could not connect."); } $ok = mongo_remove($conn, "www.users", $rquery, false); ?> ]]> </programlisting> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>mongo_insert</function></member> <member><function>mongo_update</function></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/mongo/functions/mongo-query.xml?view=markup&rev=1.1 Index: phpdoc-ja/reference/mongo/functions/mongo-query.xml +++ phpdoc-ja/reference/mongo/functions/mongo-query.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: takagi Status: ready --> <refentry xml:id="function.mongo-query" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>mongo_query</refname> <refpurpose>基本的なデータベースへの問い合わせを実行する</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>resource</type><methodname>mongo_query</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> <methodparam><type>string</type><parameter>ns</parameter></methodparam> <methodparam><type>array</type><parameter>query</parameter></methodparam> <methodparam><type>int</type><parameter>skip</parameter></methodparam> <methodparam><type>int</type><parameter>limit</parameter></methodparam> <methodparam><type>array</type><parameter>sort</parameter></methodparam> <methodparam><type>array</type><parameter>fields</parameter></methodparam> <methodparam><type>array</type><parameter>hint</parameter></methodparam> </methodsynopsis> <para> データベースへの問い合わせを実行します。返されたカーソルは mongo_has_next あるいは mongo_next に渡すことができます。 しかし、かわりに MongoCollection の find() 関数を使うことを強く推奨します。 find() 関数は基本的にはこの関数のラッパーですが、 ユーザ向けにパラメータリストを拡張しています。 </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>connection</parameter></term> <listitem> <para> 使用するデータベース接続。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>ns</parameter></term> <listitem> <para> データベースおよびコレクションの名前。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>query</parameter></term> <listitem> <para> 実行するクエリ。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>skip</parameter></term> <listitem> <para> 読み飛ばすドキュメント数。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>limit</parameter></term> <listitem> <para> 返すドキュメントの最大数。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>sort</parameter></term> <listitem> <para> ソートするフィールドおよび方向の配列。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>fields</parameter></term> <listitem> <para> 各ドキュメントから返すフィールドの配列。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>hint</parameter></term> <listitem> <para> クエリのヒントをデータベースに渡すための配列。 </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> 結果のドキュメントへのカーソルを返します。 </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>mongo_query</function> の例</title> <para> この例は、データベースの検索結果からページを取得する方法を示します。 </para> <programlisting role="php"> <![CDATA[ <?php $searchterm = "pandas"; $pagenum = 2; $resultsPerPage = 10; $conn = mongo_connect("localhost", true); if (!$conn) { die("Could not connect."); } $cursor = mongo_query($conn, "zoo.animals", array("name" => $searchterm), ($pagenum-1)*$resultsPerPage, $resultsPerPage, null, null, null); ?> ]]> </programlisting> <para> これは、zoo.animals コレクション内にある name フィールドが "panda" であるオブジェクトのうち 11 件目から 20 件目までを返します。 </para> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>mongo_has_next</function></member> <member><function>mongo_next</function></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/mongo/functions/mongo-gridfs-store.xml?view=markup&rev=1.1 Index: phpdoc-ja/reference/mongo/functions/mongo-gridfs-store.xml +++ phpdoc-ja/reference/mongo/functions/mongo-gridfs-store.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: takagi Status: ready --> <refentry xml:id="function.mongo-gridfs-store" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>mongo_gridfs_store</refname> <refpurpose>データベースにファイルを格納する</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>MongoId</type><methodname>mongo_gridfs_store</methodname> <methodparam><type>resource</type><parameter>gridfs</parameter></methodparam> <methodparam><type>string</type><parameter>filename</parameter></methodparam> </methodsynopsis> <para> ファイルをデータベースに格納します。 </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>gridfs</parameter></term> <listitem> <para> 使用する gridfs 接続。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>filename</parameter></term> <listitem> <para> 格納するファイルの名前。 </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> データベースに保存したファイルに対して与えられた MongoId を返します。 </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>mongo_gridfs_init</function></member> <member><function>mongo_gridfs_find</function></member> <member><function>mongo_gridfs_list</function></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/mongo/functions/mongo-gridfs-list.xml?view=markup&rev=1.1 Index: phpdoc-ja/reference/mongo/functions/mongo-gridfs-list.xml +++ phpdoc-ja/reference/mongo/functions/mongo-gridfs-list.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.4 Maintainer: takagi Status: ready --> <refentry xml:id="function.mongo-gridfs-list" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>mongo_gridfs_list</refname> <refpurpose>グリッドコレクション内のファイルを問い合わせる</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>resource</type><methodname>mongo_gridfs_list</methodname> <methodparam><type>resource</type><parameter>gridfs</parameter></methodparam> <methodparam><type>array</type><parameter>query</parameter></methodparam> </methodsynopsis> <para> グリッドコレクション内のファイルを問い合わせます。 </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>gridfs</parameter></term> <listitem> <para> 使用する gridfs 接続。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>query</parameter></term> <listitem> <para> 問い合わせるファイルの品質。 </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> マッチした gridfs ファイルに関する情報へのカーソルを返します。 </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>mongo_gridfs_list</function> の例</title> <para> この例は、グリッドコレクション内のファイルの一覧を表示します。 </para> <programlisting role="php"> <![CDATA[ <?php $conn = mongo_connect("localhost", true); if (!$conn) { die("Could not connect."); } // 新しいグリッド接続を作成します $gridfs = mongo_gridfs_init($conn, "blog", "fs"); // ファイル名を問い合わせます $cursor = mongo_gridfs_list($gridfs, array("filename" => "profilePic.jpg")); while (mongo_has_next($cursor)) { $f = mongo_next($cursor); echo $f["filename"] . "\n"; } ?> ]]> </programlisting> &example.outputs.similar; <screen> <![CDATA[ file1.txt file2.txt mypic.jpg ]]> </screen> <para> これはデータベースの内容に依存します。 </para> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>mongo_gridfs_init</function></member> <member><function>mongo_gridfs_find</function></member> <member><function>mongo_gridfs_store</function></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/mongo/functions/mongo-gridfs-init.xml?view=markup&rev=1.1 Index: phpdoc-ja/reference/mongo/functions/mongo-gridfs-init.xml +++ phpdoc-ja/reference/mongo/functions/mongo-gridfs-init.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.5 Maintainer: takagi Status: ready --> <refentry xml:id="function.mongo-gridfs-init" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>mongo_gridfs_init</refname> <refpurpose>新しい gridfs 接続を作成する</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>resource</type><methodname>mongo_gridfs_init</methodname> <methodparam><type>resource</type><parameter>connection</parameter></methodparam> <methodparam><type>string</type><parameter>db</parameter></methodparam> <methodparam><type>string</type><parameter>prefix</parameter></methodparam> </methodsynopsis> <para> 新しい gridfs 接続を作成します。これを用いてデータベース内のファイルとのやりとりが可能となります。 </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>connection</parameter></term> <listitem> <para> 使用するデータベース接続。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>db</parameter></term> <listitem> <para> 使用するデータベースの名前。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>prefix</parameter></term> <listitem> <para> グリッド接続に使用するプレフィックス (通常は <literal>"fs"</literal>)。 </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> グリッドファイルシステムへの接続を返します。 </para> </refsect1> <refsect1 role="examples"> &reftitle.examples; <para> <example> <title><function>mongo_gridfs_init</function> の例</title> <para> この例は、新しい接続を作成してデータベース内のファイルを探します。 </para> <programlisting role="php"> <![CDATA[ <?php $conn = mongo_connect("localhost", true); if (!$conn) { die("Could not connect."); } // 新しいグリッド接続を作成します $gridfs = mongo_gridfs_init($conn, "blog", "fs"); // ファイル名を問い合わせます $file = mongo_gridfs_find($gridfs, array("filename" => "profilePic.jpg")); ?> ]]> </programlisting> <para> <literal>$jpg</literal> にファイルリソースが格納されます。 </para> </example> </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>mongo_gridfs_find</function></member> <member><function>mongo_gridfs_list</function></member> <member><function>mongo_gridfs_store</function></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 --> http://cvs.php.net/viewvc.cgi/phpdoc-ja/reference/mongo/functions/mongo-gridfs-find.xml?view=markup&rev=1.1 Index: phpdoc-ja/reference/mongo/functions/mongo-gridfs-find.xml +++ phpdoc-ja/reference/mongo/functions/mongo-gridfs-find.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.3 Maintainer: takagi Status: ready --> <refentry xml:id="function.mongo-gridfs-find" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>mongo_gridfs_find</refname> <refpurpose>データベース内のファイルを探す</refpurpose> </refnamediv> <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>resource</type><methodname>mongo_gridfs_find</methodname> <methodparam><type>resource</type><parameter>gridfs</parameter></methodparam> <methodparam><type>array</type><parameter>query</parameter></methodparam> </methodsynopsis> <para> データベース内のファイルを探します。 </para> </refsect1> <refsect1 role="parameters"> &reftitle.parameters; <para> <variablelist> <varlistentry> <term><parameter>gridfs</parameter></term> <listitem> <para> 使用する gridfs 接続。 </para> </listitem> </varlistentry> <varlistentry> <term><parameter>query</parameter></term> <listitem> <para> 問い合わせるファイルの品質。 </para> </listitem> </varlistentry> </variablelist> </para> </refsect1> <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> グリッドファイルを返します。 </para> </refsect1> <refsect1 role="seealso"> &reftitle.seealso; <para> <simplelist> <member><function>mongo_gridfs_init</function></member> <member><function>mongo_gridfs_list</function></member> <member><function>mongo_gridfs_store</function></member> </simplelist> </para> </refsect1> </refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml sgml-omittag:t sgml-shorttag:t sgml-minimize-attributes:nil sgml-always-quote-attributes:t sgml-indent-step:1 sgml-indent-data:t indent-tabs-mode:nil sgml-parent-document:nil sgml-default-dtd-file:"../../../../manual.ced" sgml-exposed-tags:nil sgml-local-catalogs:nil sgml-local-ecat-files:nil End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 -->