improve upgrade instruction for AR::instance()

issue yiisoft#14767
mihailrad · Sep 8, 2017 · 5ccbe85 · 5ccbe85
1 parent 36b535c
commit 5ccbe85
Showing 1 changed file with 6 additions and 2 deletions.
diff --git a/framework/UPGRADE.md b/framework/UPGRADE.md
@@ -109,8 +109,12 @@ Upgrade from Yii 2.0.12
   instead. It is not possible to allow Yii versions `<2.0.13` and be compatible with PHP 7.2 or higher.
 
 * A new method `public static function instance($refresh = false);` has been added to the `yii\db\ActiveRecordInterface`.
-  This method is implemented in the `yii\base\Model`, so the change only affects your code if you implement `ActiveRecordInterface`
-  in a class that does not extend `Model`.
+  This change may affect your application in the following ways:
+
+  - If you have an `instance()` method defined in an `ActiveRecord` or `Model` class, you need to check whether the behavior is
+    compatible with the method added by Yii.
+  - Otherwise this method is implemented in the `yii\base\Model`, so the change only affects your code if you implement `ActiveRecordInterface`
+    in a class that does not extend `Model`.
 
 Upgrade from Yii 2.0.11
 -----------------------