Merge branch 'master' into transaction

Author: ziaratban

CHANGELOG.md

@@ -4,7 +4,9 @@ Yii Framework 2 mongodb extension Change Log
 2.1.10 under development
 ------------------------
 
-- Enh #294: Add transactions support (ziaratban)
+- Enh #294: transactions support (ziaratban)
+- Bug #308: Fix `yii\mongodb\file\Upload::addFile()` error when uploading file with readonly permissions (sparchatus)
+
 
 
 2.1.9 November 19, 2019

docs/guide-ja/topics-migrations.md

@@ -30,3 +30,26 @@ yii mongodb-migrate
 # 最後に適用されたマイグレーションを取り消す
 yii mongodb-migrate/down
 ```
+## 二つ以上の DB エンジンを使用するアプリケーションのための特殊な構成
+
+アプリケーションが複数のデータベースを使う場合の例です。
+
+- MySQL + MongoDB
+
+マイグレーション・コマンドを実行すると、同時に MySQL と MongoDB の両方のマイグレーション・ファイルが対象として扱われます。これは両者が既定では同じフォルダを共有するためです。
+
+**問題: MongoDB が MySQL のマイグレーション・ファイルを実行しようとし、MySQL が MongoDB のマイグレーション・ファイルを実行しようとする。**
+
+この問題を回避するためには、`migrations` フォルダの下に `mongodb` という新しいフォルダを作って、コンソール・アプリケーションを次のようにセットアップすることが出来ます。
+
+```php
+return [
+    // ...
+    'controllerMap' => [
+        'mongodb-migrate' => [
+          'class' => 'yii\mongodb\console\controllers\MigrateController',
+          'migrationPath' => '@app/migrations/mongodb',
+        ],
+    ],
+];
+```

src/file/Upload.php

@@ -178,7 +178,7 @@ public function addFile($filename)
             $this->filename = basename($filename);
         }
 
-        $stream = fopen($filename, 'r+');
+        $stream = fopen($filename, 'r');
         if ($stream === false) {
             throw new InvalidParamException("Unable to read file '{$filename}'");
         }
@@ -277,4 +277,4 @@ private function insertFile()
         $this->collection->insert($fileDocument);
         return $fileDocument;
     }
-}
+}