Yii2的深入学习-yiibaseObject 类-php教程-PHP中文网

首页

后端开发

php教程

Yii2的深入学习-yiibaseObject 类

WBOYWBOYWBOYWBOYWBOYWBOYWBOYWBOYWBOYWBOYWBOYWBOYWB

Jun 13, 2016 pm 12:27 PM

functionnamenbsppropertypublic

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

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

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

<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 和 __set 方法，下面我们来详细看下这两个方法：

    <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属性名() 的函数。如， SomeObject->Foo ，会自动调用 SomeObject->getFoo()。如果修改某一属性，会调用相应的setter函数。如， SomeObject->Foo = $someValue ，会自动调用 SomeObject->setFoo($someValue) 。

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

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

所以通常属性是 private 的，举个例子如下：

<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>

我们还可以在 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

PHP与Python：了解差异Apr 11, 2025 am 12:15 AM

PHP和Python各有优势，选择应基于项目需求。1.PHP适合web开发，语法简单，执行效率高。2.Python适用于数据科学和机器学习，语法简洁，库丰富。

php：死亡还是简单地适应？Apr 11, 2025 am 12:13 AM

PHP不是在消亡，而是在不断适应和进化。1)PHP从1994年起经历多次版本迭代，适应新技术趋势。2)目前广泛应用于电子商务、内容管理系统等领域。3)PHP8引入JIT编译器等功能，提升性能和现代化。4)使用OPcache和遵循PSR-12标准可优化性能和代码质量。

PHP的未来：改编和创新Apr 11, 2025 am 12:01 AM

PHP的未来将通过适应新技术趋势和引入创新特性来实现：1)适应云计算、容器化和微服务架构，支持Docker和Kubernetes；2)引入JIT编译器和枚举类型，提升性能和数据处理效率；3)持续优化性能和推广最佳实践。

您什么时候使用特质与PHP中的抽象类或接口？Apr 10, 2025 am 09:39 AM

在PHP中，trait适用于需要方法复用但不适合使用继承的情况。1)trait允许在类中复用方法，避免多重继承复杂性。2)使用trait时需注意方法冲突，可通过insteadof和as关键字解决。3)应避免过度使用trait，保持其单一职责，以优化性能和提高代码可维护性。

什么是依赖性注入容器（DIC），为什么在PHP中使用一个？Apr 10, 2025 am 09:38 AM

依赖注入容器（DIC）是一种管理和提供对象依赖关系的工具，用于PHP项目中。DIC的主要好处包括：1.解耦，使组件独立，代码易维护和测试；2.灵活性，易替换或修改依赖关系；3.可测试性，方便注入mock对象进行单元测试。

与常规PHP阵列相比，解释SPL SplfixedArray及其性能特征。Apr 10, 2025 am 09:37 AM

SplFixedArray在PHP中是一种固定大小的数组，适用于需要高性能和低内存使用量的场景。1)它在创建时需指定大小，避免动态调整带来的开销。2)基于C语言数组，直接操作内存，访问速度快。3)适合大规模数据处理和内存敏感环境，但需谨慎使用，因其大小固定。

PHP如何安全地上载文件？Apr 10, 2025 am 09:37 AM

PHP通过$\_FILES变量处理文件上传，确保安全性的方法包括：1.检查上传错误，2.验证文件类型和大小，3.防止文件覆盖，4.移动文件到永久存储位置。

什么是无效的合并操作员（??）和无效分配运算符（?? =）？Apr 10, 2025 am 09:33 AM

JavaScript中处理空值可以使用NullCoalescingOperator(??)和NullCoalescingAssignmentOperator(??=)。1.??返回第一个非null或非undefined的操作数。2.??=将变量赋值为右操作数的值，但前提是该变量为null或undefined。这些操作符简化了代码逻辑，提高了可读性和性能。

See all articles