搜索
首页php教程php手册Yii2的深入学习--yiibaseObject 类,yii2--yii

Yii2的深入学习--yii\base\Object 类,yii2--yii

之前我们说过 Yii2 中大多数类都继承自 yii\base\Object,今天就让我们来看一下这个类。

Object 是一个基础类,实现了属性的功能,其基本内容如下:

<?<span>php
namespace yii\base;

</span><span>use</span><span> Yii;

</span><span>/*</span><span>*
 * Object 是一个基础类,实现了属性的功能
 * Yii最基础的类,大多数类都继承了该类
 </span><span>*/</span>
<span>class</span> <span>Object</span> <span>implements</span><span> Configurable
{
    </span><span>/*</span><span>*
     * 获取静态方法调用的类名。返回类的名称,如果不是在类中调用则返回 FALSE。
     </span><span>*/</span>
    <span>public</span> <span>static</span> <span>function</span><span> className()
    {
        </span>...<span>
    }

    </span><span>/*</span><span>*
     * Constructor.
     </span><span>*/</span>
    <span>public</span> <span>function</span> __construct(<span>$config</span> =<span> [])
    {
        </span>...<span>
    }

    </span><span>/*</span><span>*
     * 初始化对象
     </span><span>*/</span>
    <span>public</span> <span>function</span><span> init()
    {
    }

    </span><span>/*</span><span>*
     * 魔术方法,实现 getter
     </span><span>*/</span>
    <span>public</span> <span>function</span> __get(<span>$name</span><span>)
    {
        </span>...<span>
    }

    </span><span>/*</span><span>*
     * 魔术方法,实现 setter
     </span><span>*/</span>
    <span>public</span> <span>function</span> __set(<span>$name</span>, <span>$value</span><span>)
    {
        </span>...<span>
    }

    </span><span>/*</span><span>*
     * 魔术方法,实现 isset,基于 getter 实现,有 getter 方法的属性才算存在
     </span><span>*/</span>
    <span>public</span> <span>function</span> __isset(<span>$name</span><span>)
    {
        </span>...<span>
    }

    </span><span>/*</span><span>*
     * 魔术方法,实现 unset,基于 setter 实现,有 setter 方法的属性才能 unset 掉
     </span><span>*/</span>
    <span>public</span> <span>function</span> __unset(<span>$name</span><span>)
    {
        </span>...<span>
    }

    </span><span>/*</span><span>*
     * Calls the named method which is not a class method.
     </span><span>*/</span>
    <span>public</span> <span>function</span> __call(<span>$name</span>, <span>$params</span><span>)
    {
        </span>...<span>
    }

    </span><span>/*</span><span>*
     * 检查对象或类是否具有 $name 属性,如果 $checkVars 为 true,则不局限于是否有 getter/setter
     </span><span>*/</span>
    <span>public</span> <span>function</span> hasProperty(<span>$name</span>, <span>$checkVars</span> = <span>true</span><span>)
    {
        </span>...<span>
    }

    </span><span>/*</span><span>*
     * 检查对象或类是否能够获取 $name 属性,如果 $checkVars 为 true,则不局限于是否有 getter
     </span><span>*/</span>
    <span>public</span> <span>function</span> canGetProperty(<span>$name</span>, <span>$checkVars</span> = <span>true</span><span>)
    {
        </span>...<span>
    }

    </span><span>/*</span><span>*
     * 检查对象或类是否能够设置 $name 属性,如果 $checkVars 为 true,则不局限于是否有 setter
     </span><span>*/</span>
    <span>public</span> <span>function</span> canSetProperty(<span>$name</span>, <span>$checkVars</span> = <span>true</span><span>)
    {
        </span>...<span>
    }

    </span><span>/*</span><span>*
     * 检查对象或类是否具有 $name 方法
     </span><span>*/</span>
    <span>public</span> <span>function</span> hasMethod(<span>$name</span><span>)
    {
        </span>...<span>
    }
}</span>

如果想看详细的注释的话,可以访问 https://github.com/ReadCode/yii2-2.0.3-annotated/blob/master/framework/base/Object.php

从上面的内容中,我们可以看到 Object 类重写了 __get 和 __set 方法,下面我们来详细看下这两个方法:

    <span>/*</span><span>*
     * 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>*/</span>
    <span>public</span> <span>function</span> __get(<span>$name</span><span>)
    {
        </span><span>$getter</span> = 'get' . <span>$name</span><span>;
        </span><span>if</span> (<span>method_exists</span>(<span>$this</span>, <span>$getter</span><span>)) {
            </span><span>//</span><span> 对象存在 $getter 方法,就直接调用</span>
            <span>return</span> <span>$this</span>-><span>$getter</span><span>();
        } </span><span>elseif</span> (<span>method_exists</span>(<span>$this</span>, 'set' . <span>$name</span><span>)) {
            </span><span>//</span><span> 如果存在 'set' . $name 方法,就认为该属性是只写的</span>
            <span>throw</span> <span>new</span> InvalidCallException('Getting write-only property: ' . <span>get_class</span>(<span>$this</span>) . '::' . <span>$name</span><span>);
        } </span><span>else</span><span> {
            </span><span>//</span><span> 否则认为该属性不存在</span>
            <span>throw</span> <span>new</span> UnknownPropertyException('Getting unknown property: ' . <span>get_class</span>(<span>$this</span>) . '::' . <span>$name</span><span>);
        }
    }

    </span><span>/*</span><span>*
     * 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>*/</span>
    <span>public</span> <span>function</span> __set(<span>$name</span>, <span>$value</span><span>)
    {
        </span><span>$setter</span> = 'set' . <span>$name</span><span>;
        </span><span>if</span> (<span>method_exists</span>(<span>$this</span>, <span>$setter</span><span>)) {
            </span><span>//</span><span> 对象存在 $setter 方法,就直接调用</span>
            <span>$this</span>-><span>$setter</span>(<span>$value</span><span>);
        } </span><span>elseif</span> (<span>method_exists</span>(<span>$this</span>, 'get' . <span>$name</span><span>)) {
            </span><span>//</span><span> 如果存在 'get' . $name 方法,就认为该属性是只读的</span>
            <span>throw</span> <span>new</span> InvalidCallException('Setting read-only property: ' . <span>get_class</span>(<span>$this</span>) . '::' . <span>$name</span><span>);
        } </span><span>else</span><span> {
            </span><span>//</span><span> 否则认为该属性不存在</span>
            <span>throw</span> <span>new</span> UnknownPropertyException('Setting unknown property: ' . <span>get_class</span>(<span>$this</span>) . '::' . <span>$name</span><span>);
        }
    }</span>

基于上面的代码,我们可以看到,如果访问一个 Object 对象的某个属性, Yii会调用名为 get属性名() 的函数。如, SomeObject->Foo , 会自动调用 SomeObject->getFoo()。 如果修改某一属性,会调用相应的setter函数。 如, SomeObject->Foo $someValue ,会自动调用 SomeObject->setFoo($someValue) 。

以 SomeObject 的 Foo 为例,如果只存在 getFoo() 方法,那它就是只读的,如果只存在 setFoo() 方法,那它就是只写的,只有两个方法都存在的时候才是既可读又可写的。

需要注意的一点是只有在读取和写入对象的一个不存在的成员变量时, __get() __set() 会被自动调用。 如果 Foo 是一个 public 的属性就不会经过 __get() 和  __set() 方法了。

所以通常属性是 private 的,举个例子如下:

<span>class</span> User <span>extends</span> yii\base\<span>Object</span><span>
{
    </span><span>private</span> <span>$_name</span><span>;

    </span><span>public</span> <span>function</span><span> getName()
    {
        </span><span>return</span> <span>$this</span>-><span>_name;
    }

    </span><span>public</span> <span>function</span> setName(<span>$name</span><span>)
    {
        </span><span>$this</span>->_name = <span>trim</span>(<span>$name</span><span>);
    }
}</span>

我们还可以在 get 和 set 方法中做一些特殊的处理。

除了 __get() __set() 之外, yii\base\Object 还提供了以下方法便于使用属性:

  • __isset() 用于测试属性值是否不为 null ,在 isset($object->property) 时被自动调用。 注意该属性要有相应的 getter。
  • __unset() 用于将属性值设为 null ,在 unset($object->property) 时被自动调用。 注意该属性要有相应的 setter。
  • hasProperty() 用于测试是否有某个属性。即,定义了 getter 或 setter。 如果 hasProperty() 的参数 $checkVars true (默认为true), 那么只要具有同名的成员变量也认为具有该属性,如前面提到的 public $title 。
  • canGetProperty() 测试一个属性是否可读,参数 $checkVars 的意义同上。只要定义了 getter,属性即可读。 同时,如果 $checkVars 为 true 。那么只要类定义了成员变量,不管是 public, private 还是 protected, 都认为是可读。
  • canSetProperty() 测试一个属性是否可写,参数 $checkVars 的意义同上。只要定义了 setter,属性即可写。 同时,在 $checkVars 为 ture 。那么只要类定义了成员变量,不管是 public, private 还是 protected, 都认为是可写。

 

对 Yii2 源码有兴趣的同学可以关注项目 yii2-2.0.3-annotated,现在在上面已经添加了不少关于 Yii2 源码的注释,之后还会继续添加~

有兴趣的同学也可以参与进来,提交 Yii2 源码的注释。

 

声明
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热AI工具

Undresser.AI Undress

Undresser.AI Undress

人工智能驱动的应用程序,用于创建逼真的裸体照片

AI Clothes Remover

AI Clothes Remover

用于从照片中去除衣服的在线人工智能工具。

Undress AI Tool

Undress AI Tool

免费脱衣服图片

Clothoff.io

Clothoff.io

AI脱衣机

AI Hentai Generator

AI Hentai Generator

免费生成ai无尽的。

热门文章

R.E.P.O.能量晶体解释及其做什么(黄色晶体)
3 周前By尊渡假赌尊渡假赌尊渡假赌
R.E.P.O.最佳图形设置
3 周前By尊渡假赌尊渡假赌尊渡假赌
R.E.P.O.如果您听不到任何人,如何修复音频
3 周前By尊渡假赌尊渡假赌尊渡假赌
WWE 2K25:如何解锁Myrise中的所有内容
3 周前By尊渡假赌尊渡假赌尊渡假赌

热工具

WebStorm Mac版

WebStorm Mac版

好用的JavaScript开发工具

禅工作室 13.0.1

禅工作室 13.0.1

功能强大的PHP集成开发环境

SublimeText3 英文版

SublimeText3 英文版

推荐:为Win版本,支持代码提示!

SublimeText3 Mac版

SublimeText3 Mac版

神级代码编辑软件(SublimeText3)

DVWA

DVWA

Damn Vulnerable Web App (DVWA) 是一个PHP/MySQL的Web应用程序,非常容易受到攻击。它的主要目标是成为安全专业人员在合法环境中测试自己的技能和工具的辅助工具,帮助Web开发人员更好地理解保护Web应用程序的过程,并帮助教师/学生在课堂环境中教授/学习Web应用程序安全。DVWA的目标是通过简单直接的界面练习一些最常见的Web漏洞,难度各不相同。请注意,该软件中