init

vendor/yiisoft/yii2/base/StaticInstanceInterface.php

@@ -0,0 +1,30 @@
+<?php
+/**
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright (c) 2008 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+namespace yii\base;
+
+/**
+ * StaticInstanceInterface is the interface for providing static instances to classes,
+ * which can be used to obtain class meta information that can not be expressed in static methods.
+ * For example: adjustments made by DI or behaviors reveal only at object level, but might be needed
+ * at class (static) level as well.
+ *
+ * To implement the [[instance()]] method you may use [[StaticInstanceTrait]].
+ *
+ * @author Paul Klimov <klimov.paul@gmail.com>
+ * @since 2.0.13
+ * @see StaticInstanceTrait
+ */
+interface StaticInstanceInterface
+{
+    /**
+     * Returns static class instance, which can be used to obtain meta information.
+     * @param bool $refresh whether to re-create static instance even, if it is already cached.
+     * @return static class instance.
+     */
+    public static function instance($refresh = false);
+}