Yii2-yiibaseObjectクラスの詳細な学習

Yii2 の詳細な学習 -- yiibaseObject クラス

Yii2 のほとんどのクラスは yiibaseObject から継承していると前に述べました。今日はこのクラスを見てみましょう。

オブジェクトは属性の機能を実装する基本クラスです。その基本的な内容は次のとおりです。

<span style="color: #000000;">phpnamespace yii\base;</span><span style="color: #0000ff;">use</span><span style="color: #000000;"> Yii;</span><span style="color: #008000;">/*</span><span style="color: #008000;">* * Object 是一个基础类，实现了属性的功能 * Yii最基础的类，大多数类都继承了该类 </span><span style="color: #008000;">*/</span><span style="color: #0000ff;">class</span> <span style="color: #0000ff;">Object</span> <span style="color: #0000ff;">implements</span><span style="color: #000000;"> Configurable{    </span><span style="color: #008000;">/*</span><span style="color: #008000;">*     * 获取静态方法调用的类名。返回类的名称，如果不是在类中调用则返回 FALSE。     </span><span style="color: #008000;">*/</span>    <span style="color: #0000ff;">public</span> <span style="color: #0000ff;">static</span> <span style="color: #0000ff;">function</span><span style="color: #000000;"> className()    {        </span>...<span style="color: #000000;">    }    </span><span style="color: #008000;">/*</span><span style="color: #008000;">*     * Constructor.     </span><span style="color: #008000;">*/</span>    <span style="color: #0000ff;">public</span> <span style="color: #0000ff;">function</span> __construct(<span style="color: #800080;">$config</span> =<span style="color: #000000;"> [])    {        </span>...<span style="color: #000000;">    }    </span><span style="color: #008000;">/*</span><span style="color: #008000;">*     * 初始化对象     </span><span style="color: #008000;">*/</span>    <span style="color: #0000ff;">public</span> <span style="color: #0000ff;">function</span><span style="color: #000000;"> init()    {    }    </span><span style="color: #008000;">/*</span><span style="color: #008000;">*     * 魔术方法，实现 getter     </span><span style="color: #008000;">*/</span>    <span style="color: #0000ff;">public</span> <span style="color: #0000ff;">function</span> __get(<span style="color: #800080;">$name</span><span style="color: #000000;">)    {        </span>...<span style="color: #000000;">    }    </span><span style="color: #008000;">/*</span><span style="color: #008000;">*     * 魔术方法，实现 setter     </span><span style="color: #008000;">*/</span>    <span style="color: #0000ff;">public</span> <span style="color: #0000ff;">function</span> __set(<span style="color: #800080;">$name</span>, <span style="color: #800080;">$value</span><span style="color: #000000;">)    {        </span>...<span style="color: #000000;">    }    </span><span style="color: #008000;">/*</span><span style="color: #008000;">*     * 魔术方法，实现 isset，基于 getter 实现，有 getter 方法的属性才算存在     </span><span style="color: #008000;">*/</span>    <span style="color: #0000ff;">public</span> <span style="color: #0000ff;">function</span> __isset(<span style="color: #800080;">$name</span><span style="color: #000000;">)    {        </span>...<span style="color: #000000;">    }    </span><span style="color: #008000;">/*</span><span style="color: #008000;">*     * 魔术方法，实现 unset，基于 setter 实现，有 setter 方法的属性才能 unset 掉     </span><span style="color: #008000;">*/</span>    <span style="color: #0000ff;">public</span> <span style="color: #0000ff;">function</span> __unset(<span style="color: #800080;">$name</span><span style="color: #000000;">)    {        </span>...<span style="color: #000000;">    }    </span><span style="color: #008000;">/*</span><span style="color: #008000;">*     * Calls the named method which is not a class method.     </span><span style="color: #008000;">*/</span>    <span style="color: #0000ff;">public</span> <span style="color: #0000ff;">function</span> __call(<span style="color: #800080;">$name</span>, <span style="color: #800080;">$params</span><span style="color: #000000;">)    {        </span>...<span style="color: #000000;">    }    </span><span style="color: #008000;">/*</span><span style="color: #008000;">*     * 检查对象或类是否具有 $name 属性，如果 $checkVars 为 true，则不局限于是否有 getter/setter     </span><span style="color: #008000;">*/</span>    <span style="color: #0000ff;">public</span> <span style="color: #0000ff;">function</span> hasProperty(<span style="color: #800080;">$name</span>, <span style="color: #800080;">$checkVars</span> = <span style="color: #0000ff;">true</span><span style="color: #000000;">)    {        </span>...<span style="color: #000000;">    }    </span><span style="color: #008000;">/*</span><span style="color: #008000;">*     * 检查对象或类是否能够获取 $name 属性，如果 $checkVars 为 true，则不局限于是否有 getter     </span><span style="color: #008000;">*/</span>    <span style="color: #0000ff;">public</span> <span style="color: #0000ff;">function</span> canGetProperty(<span style="color: #800080;">$name</span>, <span style="color: #800080;">$checkVars</span> = <span style="color: #0000ff;">true</span><span style="color: #000000;">)    {        </span>...<span style="color: #000000;">    }    </span><span style="color: #008000;">/*</span><span style="color: #008000;">*     * 检查对象或类是否能够设置 $name 属性，如果 $checkVars 为 true，则不局限于是否有 setter     </span><span style="color: #008000;">*/</span>    <span style="color: #0000ff;">public</span> <span style="color: #0000ff;">function</span> canSetProperty(<span style="color: #800080;">$name</span>, <span style="color: #800080;">$checkVars</span> = <span style="color: #0000ff;">true</span><span style="color: #000000;">)    {        </span>...<span style="color: #000000;">    }    </span><span style="color: #008000;">/*</span><span style="color: #008000;">*     * 检查对象或类是否具有 $name 方法     </span><span style="color: #008000;">*/</span>    <span style="color: #0000ff;">public</span> <span style="color: #0000ff;">function</span> hasMethod(<span style="color: #800080;">$name</span><span style="color: #000000;">)    {        </span>...<span style="color: #000000;">    }}</span>

詳細なコメントを参照したい場合は、 https://github.com/ReadCode/yii2-2.0.3-annotated/blob/master/framework/base/Object.php

上記の内容から、Object クラスが __get をオーバーライドしていることがわかります。

    <span style="color: #008000;">/*</span><span style="color: #008000;">*     * Returns the value of an object property.     *     * Do not call this method directly as it is a PHP magic method that     * will be implicitly called when executing `$value = $object->property;`.     *     * 魔术方法，实现 getter     *     * @param string $name the property name     * @return mixed the property value     * @throws UnknownPropertyException if the property is not defined     * @throws InvalidCallException if the property is write-only     * @see __set()     </span><span style="color: #008000;">*/</span>    <span style="color: #0000ff;">public</span> <span style="color: #0000ff;">function</span> __get(<span style="color: #800080;">$name</span><span style="color: #000000;">)    {        </span><span style="color: #800080;">$getter</span> = 'get' . <span style="color: #800080;">$name</span><span style="color: #000000;">;        </span><span style="color: #0000ff;">if</span> (<span style="color: #008080;">method_exists</span>(<span style="color: #800080;">$this</span>, <span style="color: #800080;">$getter</span><span style="color: #000000;">)) {            </span><span style="color: #008000;">//</span><span style="color: #008000;"> 对象存在 $getter 方法，就直接调用</span>            <span style="color: #0000ff;">return</span> <span style="color: #800080;">$this</span>-><span style="color: #800080;">$getter</span><span style="color: #000000;">();        } </span><span style="color: #0000ff;">elseif</span> (<span style="color: #008080;">method_exists</span>(<span style="color: #800080;">$this</span>, 'set' . <span style="color: #800080;">$name</span><span style="color: #000000;">)) {            </span><span style="color: #008000;">//</span><span style="color: #008000;"> 如果存在 'set' . $name 方法，就认为该属性是只写的</span>            <span style="color: #0000ff;">throw</span> <span style="color: #0000ff;">new</span> InvalidCallException('Getting write-only property: ' . <span style="color: #008080;">get_class</span>(<span style="color: #800080;">$this</span>) . '::' . <span style="color: #800080;">$name</span><span style="color: #000000;">);        } </span><span style="color: #0000ff;">else</span><span style="color: #000000;"> {            </span><span style="color: #008000;">//</span><span style="color: #008000;"> 否则认为该属性不存在</span>            <span style="color: #0000ff;">throw</span> <span style="color: #0000ff;">new</span> UnknownPropertyException('Getting unknown property: ' . <span style="color: #008080;">get_class</span>(<span style="color: #800080;">$this</span>) . '::' . <span style="color: #800080;">$name</span><span style="color: #000000;">);        }    }    </span><span style="color: #008000;">/*</span><span style="color: #008000;">*     * Sets value of an object property.     *     * Do not call this method directly as it is a PHP magic method that     * will be implicitly called when executing `$object->property = $value;`.     *     * 魔术方法，实现 setter     *     * @param string $name the property name or the event name     * @param mixed $value the property value     * @throws UnknownPropertyException if the property is not defined     * @throws InvalidCallException if the property is read-only     * @see __get()     </span><span style="color: #008000;">*/</span>    <span style="color: #0000ff;">public</span> <span style="color: #0000ff;">function</span> __set(<span style="color: #800080;">$name</span>, <span style="color: #800080;">$value</span><span style="color: #000000;">)    {        </span><span style="color: #800080;">$setter</span> = 'set' . <span style="color: #800080;">$name</span><span style="color: #000000;">;        </span><span style="color: #0000ff;">if</span> (<span style="color: #008080;">method_exists</span>(<span style="color: #800080;">$this</span>, <span style="color: #800080;">$setter</span><span style="color: #000000;">)) {            </span><span style="color: #008000;">//</span><span style="color: #008000;"> 对象存在 $setter 方法，就直接调用</span>            <span style="color: #800080;">$this</span>-><span style="color: #800080;">$setter</span>(<span style="color: #800080;">$value</span><span style="color: #000000;">);        } </span><span style="color: #0000ff;">elseif</span> (<span style="color: #008080;">method_exists</span>(<span style="color: #800080;">$this</span>, 'get' . <span style="color: #800080;">$name</span><span style="color: #000000;">)) {            </span><span style="color: #008000;">//</span><span style="color: #008000;"> 如果存在 'get' . $name 方法，就认为该属性是只读的</span>            <span style="color: #0000ff;">throw</span> <span style="color: #0000ff;">new</span> InvalidCallException('Setting read-only property: ' . <span style="color: #008080;">get_class</span>(<span style="color: #800080;">$this</span>) . '::' . <span style="color: #800080;">$name</span><span style="color: #000000;">);        } </span><span style="color: #0000ff;">else</span><span style="color: #000000;"> {            </span><span style="color: #008000;">//</span><span style="color: #008000;"> 否则认为该属性不存在</span>            <span style="color: #0000ff;">throw</span> <span style="color: #0000ff;">new</span> UnknownPropertyException('Setting unknown property: ' . <span style="color: #008080;">get_class</span>(<span style="color: #800080;">$this</span>) . '::' . <span style="color: #800080;">$name</span><span style="color: #000000;">);        }    }</span>

上記のコードに基づくと、Object オブジェクトの特定のプロパティにアクセスすると、 Yii は get Attribute name() という名前の関数を呼び出します。たとえば、SomeObject->Foo は自動的に SomeObject->getFoo() を呼び出します。 プロパティが変更されると、対応するセッター関数が呼び出されます。 たとえば、SomeObject->Foo = $someValue は自動的に SomeObject->setFoo( $someValue) 。

SomeObject の Foo を例に挙げます。getFoo() メソッドのみが存在する場合、それは読み取り専用であり、setFoo() メソッドのみが存在します。そうして初めて、読み取りと書き込みの両方が可能になります。

注意すべき点は、オブジェクトの存在しないメンバー変数を読み書きする場合のみ、__get() __set ( ) が自動的に呼び出されます。 Foo がパブリック プロパティの場合、__get() メソッドと __set() メソッドを経由しません。

通常、属性はプライベートです。たとえば、次のようになります。

<span style="color: #0000ff;">class</span> User <span style="color: #0000ff;">extends</span> yii\base\<span style="color: #0000ff;">Object</span><span style="color: #000000;">{    </span><span style="color: #0000ff;">private</span> <span style="color: #800080;">$_name</span><span style="color: #000000;">;    </span><span style="color: #0000ff;">public</span> <span style="color: #0000ff;">function</span><span style="color: #000000;"> getName()    {        </span><span style="color: #0000ff;">return</span> <span style="color: #800080;">$this</span>-><span style="color: #000000;">_name;    }    </span><span style="color: #0000ff;">public</span> <span style="color: #0000ff;">function</span> setName(<span style="color: #800080;">$name</span><span style="color: #000000;">)    {        </span><span style="color: #800080;">$this</span>->_name = <span style="color: #008080;">trim</span>(<span style="color: #800080;">$name</span><span style="color: #000000;">);    }}</span>

また、いくつかの特別な情報を取得して実行することもできます。 setメソッドでの処理です。

__get() __set() に加えて、yiibaseObject は、属性の使用を容易にする次のメソッドも提供します。

• __isset() は、null でないかどうかをテストするために使用されます。 🎜> isset($object->property) が自動的に呼び出されます。 このプロパティには対応するゲッターが必要であることに注意してください。
• __unset() は、 で属性値を null に設定するために使用されます。 unset ($object->property) が自動的に呼び出されます。 このプロパティには対応するセッターが必要であることに注意してください。
• hasProperty() は、特定のプロパティが存在するかどうかをテストするために使用されます。つまり、ゲッターまたはセッターが定義されます。 hasProperty() $checkVars = true の場合 (デフォルトはtrue )、前述したように、同じ名前のメンバー変数もこの属性を持つものとみなされます。 public $title 。
• canGetProperty() パラメーター $checkVars は、上記と同じ意味を持ちます。 。ゲッターが定義されている限り、プロパティは読み取り可能です。 同時に、 $checkVars が true の場合。クラスがメンバー変数を定義している限り、パブリック、プライベート、保護のいずれであっても、それらは読み取り可能であるとみなされます。
• canSetProperty() パラメータ $checkVars は上記と同じ意味を持ちます。 。 setter が定義されていれば、プロパティを書き込むことができます。 同時に、 $checkVars は ture です。次に、クラスがメンバー変数を定義している限り、メンバー変数がパブリック、プライベート、または保護されているかどうかに関係なく、書き込み可能とみなされます。

Yii2 ソース コードに興味がある学生は、yii2-2.0.3-annotated のプロジェクトに注目してください。Yii2 ソース コードに関する多くのコメントが書き込まれています。追加され、将来的にはさらに追加される予定です~

興味のある学生も参加して、Yii2 ソース コードにコメントを送信できます。