Modified: phpdoc/ja/trunk/features/file-upload.xml =================================================================== --- phpdoc/ja/trunk/features/file-upload.xml 2014-08-01 23:59:43 UTC (rev 334456) +++ phpdoc/ja/trunk/features/file-upload.xml 2014-08-02 01:32:40 UTC (rev 334457) @@ -432,7 +432,7 @@ - + 複数ファイルのアップロード input で異なった name を Modified: phpdoc/ja/trunk/language-snippets.ent =================================================================== --- phpdoc/ja/trunk/language-snippets.ent 2014-08-01 23:59:43 UTC (rev 334456) +++ phpdoc/ja/trunk/language-snippets.ent 2014-08-02 01:32:40 UTC (rev 334457) @@ -1,6 +1,6 @@ - + 4.2.0 @@ -1819,7 +1819,7 @@ WriteConcerns を参照ください。MongoClient でのデフォルト値は 1 です。 '> "wtimeout"廃止予定。"wTimeoutMS" のエイリアスです。'> -"wTimeoutMS"write concern の確認をいつまで待つか。MongoClient でのデフォルトは 10000 ミリ秒です。'> +"wTimeoutMS"このオプションは、書き込み確認を待つ制限時間をミリ秒単位で指定します。これが書き込み操作に適用されるのは、"w" が 1 より大きい場合のみです。というのも、タイムアウトはレプリケーションに関する機能だからです。この時間内に書き込み確認ができなかった場合は MongoCursorException をスローします。0 を指定すると、永遠にブロックし続けます。MongoClient でのデフォルトは 10000 ミリ秒 (10 秒) です。'> "fsync" Boolean 型で、デフォルトは &false; です。 ジャーナリングが有効な場合、これは "j" とまったく同じ動きをします。 @@ -1833,10 +1833,10 @@ "j"デフォルトは &false; です。これを指定すると、追加をジャーナルに同期させるまで成功したと見なさないようになります。&true; にすると確認付き書き込みと見なされ、"w" の設定を 0 に上書きします。このオプションを使っているときにジャーナリングを無効にすると、MongoDB 2.6 以降ではエラーが発生して書き込みに失敗します。古いバージョンのサーバーでは、単純にオプションの指定を無視します。'> "safe"非推奨。write concern の w オプションを使いましょう。'> "timeout"非推奨。"socketTimeoutMS" のエイリアス。'> -"w" オプションが設定されていて書き込みが失敗した場合に MongoCursorException をスローします。"w" オプションの値が 1 より大きく設定されていて、操作の完了までの時間が MongoCursor::$timeout ミリ秒をこえた場合に MongoCursorTimeoutException をスローします。サーバー上での操作は止めません。これはクライアント側でのタイムアウトです。MongoCollection::$wtimeout はミリ秒です。'> +"w" オプションが設定されていて書き込みが失敗した場合に MongoCursorException をスローします。"w" オプションの値が 1 より大きく設定されていて、操作の完了までの時間が MongoCursor::$timeout ミリ秒をこえた場合に MongoCursorTimeoutException をスローします。サーバー上での操作は止めません。これはクライアント側でのタイムアウトです。MongoCollection::$wtimeout はミリ秒です。'> E_DEPRECATED が発生します。'> これらのフィールドは、ドライバが自動生成したフィールドも上書きします。詳しい説明は、MongoDB コアドキュメントの files collection を参照ください。この挙動の現実的な使い道としては、ファイルの chunkSize や _id を独自に指定する場合などがあります。'> -格納したファイルドキュメントの _id を返します。extra パラメータで _id を明示的に指定していない場合は、自動生成した MongoId となります。'> +格納したファイルドキュメントの _id を返します。metadata パラメータで _id を明示的に指定していない場合は、自動生成した MongoId となります。'> 書き込みオプションの配列。キー値w (int|string)WriteConcern の値wtimeout (int)レプリケーションを待つ時間の最大値orderedMongoDB にこのバッチを順番どおりに実行させるのか、あるいは並べ替えを許すのかを指定する。デフォルトは &true;j (bool)プライマリーへのジャーナリングを待つかどうか。これは非推奨なので、かわりに確認付き書き込みを使うことfsync (bool)プライマリーへの fsync を待つかどうか。これは非推奨なので、かわりに確認付き書き込みを使うこと'> バッチを実行する MongoCollection。確認付き書き込み をコピーして、デフォルトとして使います。$write_options で指定したり、MongoWriteBatch::execute で指定したりすることもできます。'> Modified: phpdoc/ja/trunk/reference/mongo/mongoclient/construct.xml =================================================================== --- phpdoc/ja/trunk/reference/mongo/mongoclient/construct.xml 2014-08-01 23:59:43 UTC (rev 334456) +++ phpdoc/ja/trunk/reference/mongo/mongoclient/construct.xml 2014-08-02 01:32:40 UTC (rev 334457) @@ -1,6 +1,6 @@ - + @@ -351,11 +351,17 @@ "wTimeoutMS" - このオプションは "w" と組み合わせて使います。 - 書き込み操作がうまくいくまでサーバーが何ミリ秒待つのかを制御します。 - これよりも長い時間がかかると、サーバーからドライバに対して「長すぎる」 - という通知を出し、ドライバが + このオプションは、 + 書き込み確認 + を待つ制限時間をミリ秒単位で指定します。 + これが書き込み操作に適用されるのは、 + "w" が 1 より大きい場合のみです。 + というのも、タイムアウトはレプリケーションに関する機能だからです。 + この時間内に書き込み確認ができなかった場合は MongoCursorException をスローします。 + 0 を指定すると、永遠にブロックし続けます。 + デフォルト値は 10000 + (10 秒) です。 @@ -648,6 +654,10 @@ 1.4.0 + "ssl" オプションが追加されました。これは + SSL 接続 をサポートするものです。 + + "wTimeoutMS" オプションが追加されました。これは "wTimeout" の代替です。 Modified: phpdoc/ja/trunk/reference/mongo/mongocollection/aggregate.xml =================================================================== --- phpdoc/ja/trunk/reference/mongo/mongocollection/aggregate.xml 2014-08-01 23:59:43 UTC (rev 334456) +++ phpdoc/ja/trunk/reference/mongo/mongocollection/aggregate.xml 2014-08-02 01:32:40 UTC (rev 334457) @@ -1,6 +1,6 @@ - + @@ -58,6 +58,8 @@ "cursor" カーソルオブジェクトの作成を制御するオプション。 + このオプションは、コマンドの実行結果として返されるドキュメントを、 + MongoCommandCursor を作るのに適した形式にします。 このオプションを使う必要がある場合は、 MongoCollection::aggregateCursor を使うことを検討しましょう。 Modified: phpdoc/ja/trunk/reference/mongo/mongocursor/timeout.xml =================================================================== --- phpdoc/ja/trunk/reference/mongo/mongocursor/timeout.xml 2014-08-01 23:59:43 UTC (rev 334456) +++ phpdoc/ja/trunk/reference/mongo/mongocursor/timeout.xml 2014-08-02 01:32:40 UTC (rev 334457) @@ -1,7 +1,7 @@ - + MongoCursor::timeout @@ -31,7 +31,7 @@ カーソルがレスポンスを待つミリ秒数。 ずっと待ち続ける場合は -1 を指定します。 - デフォルトでは、3000 ミリ秒 (3 秒) だけ待ちます。 + デフォルトでは、30000 ミリ秒 (30 秒) だけ待ちます。 Modified: phpdoc/ja/trunk/reference/mongo/mongogridfs/delete.xml =================================================================== --- phpdoc/ja/trunk/reference/mongo/mongogridfs/delete.xml 2014-08-01 23:59:43 UTC (rev 334456) +++ phpdoc/ja/trunk/reference/mongo/mongogridfs/delete.xml 2014-08-02 01:32:40 UTC (rev 334457) @@ -1,19 +1,28 @@ - + MongoGridFS::delete - ファイルをデータベースから削除する + ファイルとそのチャンクをデータベースから削除する &reftitle.description; - public boolMongoGridFS::delete + public bool|arrayMongoGridFS::delete mixedid + + + + MongoGridFS::delete は利便性のためのメソッドで、 + MongoGridFS::remove に特定の + criteria を指定して、デフォルトの options + で呼び出すのと同じ動きをします。 + + @@ -37,10 +46,21 @@ &reftitle.returnvalues; - ファイルをデータベースから削除できたか否かを返します。 + 書き込み確認 を適用している場合は、配列を返します。 + この配列には、削除が成功したかどうか (files コレクションを尊重したもの) を含みます。 + それ以外の場合は &true; を返します。 + + 配列の各フィールドの意味については、 + MongoCollection::insert のドキュメントを参照ください。 + + + &reftitle.errors; + &mongo.errors.exceptions.writeconcern; + + - + MongoGridFS::put @@ -14,36 +14,56 @@ public mixedMongoGridFS::put stringfilename arraymetadataarray() + arrayoptionsarray() + + + + MongoGridFS::put は、MongoGridFS::storeFile のエイリアスです。 + + - &reftitle.parameters; - - - - - filename - - - - 格納するファイルの名前。 - - - - - - metadata - - - - 格納するファイルに含めるその他のメタデータフィールド。 - - &mongo.gridfs.store.metadata.note; - - - - + &reftitle.parameters; + + + + + filename + + + + 格納するファイルの名前。 + + + + + + metadata + + + + 格納するファイルに含めるその他のメタデータフィールド。 + + &mongo.gridfs.store.metadata.note; + + + + + options + + + + chunks および files + コレクションに対して追加操作を実行するときの、オプションの配列。 + オプションの意味については、MongoCollection::insert + を参照ください。 + + + + + @@ -51,6 +71,16 @@ &mongo.gridfs.store.return; + + &reftitle.errors; + + filename の読み込みに失敗したり、 + chunks あるいは files + コレクションへの追加に失敗したりした場合に + MongoGridFSException をスローします。 + + + &reftitle.seealso; Modified: phpdoc/ja/trunk/reference/mongo/mongogridfs/remove.xml =================================================================== --- phpdoc/ja/trunk/reference/mongo/mongogridfs/remove.xml 2014-08-01 23:59:43 UTC (rev 334456) +++ phpdoc/ja/trunk/reference/mongo/mongogridfs/remove.xml 2014-08-02 01:32:40 UTC (rev 334457) @@ -1,17 +1,17 @@ - + MongoGridFS::remove - ファイルをコレクションから削除する + ファイルとそのチャンクをデータベースから削除する &reftitle.description; - public boolMongoGridFS::remove + public bool|arrayMongoGridFS::remove arraycriteriaarray() arrayoptionsarray() @@ -23,27 +23,27 @@ - query + criteria 探したいファイル名あるいは条件。 - + options - 削除時のオプション。以下のオプションが使えます。 + chunks および files + コレクションに対して削除操作を実行するときの、オプションの配列。 + オプションの意味については、MongoCollection::remove + を参照ください。 - - &mongo.writes.parameters.writeconcern; - - + @@ -51,10 +51,21 @@ &reftitle.returnvalues; - 削除がデータベースに正しく送信されたかどうかを返します。 + "w" オプションを設定している場合は、配列を返します。 + この配列には、削除が成功したかどうか (files コレクションを尊重したもの) を含みます。 + それ以外の場合は &true; を返します。 + + 配列の各フィールドの意味については、 + MongoCollection::insert のドキュメントを参照ください。 + + + &reftitle.errors; + &mongo.errors.exceptions.writeconcern; + + - + @@ -19,45 +19,45 @@ - &reftitle.parameters; - - - - - bytes - - - - 格納したいバイト列。 - - - - - - metadata - - - - 格納するファイルに含めるその他のメタデータフィールド。 - - &mongo.gridfs.store.metadata.note; - - - - - options - - - - 格納時のオプション。 - - &mongo.writes.parameters.writeconcern; - - - - - - + &reftitle.parameters; + + + + + bytes + + + + 格納したいバイト列。 + + + + + + metadata + + + + 格納するファイルに含めるその他のメタデータフィールド。 + + &mongo.gridfs.store.metadata.note; + + + + + options + + + + chunks および files + コレクションに対して追加操作を実行するときの、オプションの配列。 + オプションの意味については、MongoCollection::insert + を参照ください。 + + + + + @@ -67,7 +67,11 @@ &reftitle.errors; - &mongo.errors.exceptions.writeconcern; + + chunks あるいは files + コレクションへの追加に失敗した場合に + MongoGridFSException をスローします。 + Modified: phpdoc/ja/trunk/reference/mongo/mongogridfs/storefile.xml =================================================================== --- phpdoc/ja/trunk/reference/mongo/mongogridfs/storefile.xml 2014-08-01 23:59:43 UTC (rev 334456) +++ phpdoc/ja/trunk/reference/mongo/mongogridfs/storefile.xml 2014-08-02 01:32:40 UTC (rev 334457) @@ -1,6 +1,6 @@ - + @@ -19,45 +19,45 @@ - &reftitle.parameters; - - - - - filename - - - - 格納するファイルの名前。 - - - - - - metadata - - - - 格納するファイルに含めるその他のメタデータフィールド。 - - &mongo.gridfs.store.metadata.note; - - - - - options - - - - 格納時のオプション。 - - &mongo.writes.parameters.writeconcern; - - - - - - + &reftitle.parameters; + + + + + filename + + + + 格納するファイルの名前。 + + + + + + metadata + + + + 格納するファイルに含めるその他のメタデータフィールド。 + + &mongo.gridfs.store.metadata.note; + + + + + options + + + + chunks および files + コレクションに対して追加操作を実行するときの、オプションの配列。 + オプションの意味については、MongoCollection::insert + を参照ください。 + + + + + @@ -67,7 +67,12 @@ &reftitle.errors; - &mongo.errors.exceptions.writeconcern; + + filename の読み込みに失敗したり、 + chunks あるいは files + コレクションへの追加に失敗したりした場合に + MongoGridFSException をスローします。 + Modified: phpdoc/ja/trunk/reference/mongo/mongogridfs/storeupload.xml =================================================================== --- phpdoc/ja/trunk/reference/mongo/mongogridfs/storeupload.xml 2014-08-01 23:59:43 UTC (rev 334456) +++ phpdoc/ja/trunk/reference/mongo/mongogridfs/storeupload.xml 2014-08-02 01:32:40 UTC (rev 334457) @@ -1,6 +1,6 @@ - + @@ -44,7 +44,8 @@ &mongo.gridfs.store.metadata.note; - filename インデックスには、使用したファイル名が入ります。 + filename フィールドには、クライアントのファイル名 + ($_FILES['foo']['name'] など) が入ります。 @@ -56,8 +57,25 @@ &reftitle.returnvalues; &mongo.gridfs.store.return; + + + 複数のファイルを同じフィールド名でアップロード + した場合は、このメソッドは何も返しません。 + しかし、ファイル自体の処理はそのまま行われます。 + + + + &reftitle.errors; + + アップロードされたファイルの読み込みに失敗したり、 + chunks あるいは files + コレクションへの追加に失敗したりした場合に + MongoGridFSException をスローします。 + + + &reftitle.changelog; Modified: phpdoc/ja/trunk/reference/mongo/mongoid.xml =================================================================== --- phpdoc/ja/trunk/reference/mongo/mongoid.xml 2014-08-01 23:59:43 UTC (rev 334456) +++ phpdoc/ja/trunk/reference/mongo/mongoid.xml 2014-08-02 01:32:40 UTC (rev 334457) @@ -1,6 +1,6 @@ - + @@ -25,7 +25,7 @@ リレーショナルデータベースにおける自動インクリメントの役割を果たします。 つまり、データ自体が必然的にもつ一意なキーがない場合にそれを提供するということです。 自動インクリメントは共有データベースではうまく動作しません。 - 次の番号を瞬時に見つけることが不可能だからです。 + 次の番号を瞬時に見つけることが難しいからです。 このクラスは、共有環境であっても一意となる値をすばやく生成することができます。 @@ -64,7 +64,7 @@ public string - id + $id &null; @@ -79,11 +79,18 @@ フィールド - id + $id このフィールドには、このオブジェクトの文字列表現が含まれます。 + + + このプロパティの名前は $ で始まります。アクセスするには、 + 複雑な構文 ($mongoId->{'$id'} 形式) + を利用します。 + + @@ -92,7 +99,7 @@
&reftitle.seealso; - MongoDB コアドキュメントの id + MongoDB コアドキュメントの ObjectIds を参照ください。