PHP Conference Japan 2024

    property_exists

    (PHP 5 >= 5.1.0, PHP 7, PHP 8)

    property_exists — 检查对象或类是否具有属性

    描述

    property_exists(对象|字符串 $object_or_class, 字符串 $property): 布尔值

    此函数检查指定类中是否存在给定的 $property 属性。

    注意:

    与 isset() 相反，即使属性的值为 null，property_exists() 也会返回 true。

    参数

    object_or_class

    要测试的类名或类的对象

    property

    属性的名称

    返回值

    如果属性存在，则返回 true；如果属性不存在，则返回 false。

    示例

    示例 #1 property_exists() 示例

    <?php

    类 myClass {
    public     $mine;
    private     $xpto;
    static protected     $test;

    static function     test() {
    var_dump(property_exists('myClass', 'xpto')); //true
    }
    }

    var_dump(property_exists('myClass', 'mine')); //true
    var_dump(property_exists(new myClass, 'mine')); //true
    var_dump(property_exists('myClass', 'xpto')); //true
    var_dump(property_exists('myClass', 'bar')); //false
    var_dump(property_exists('myClass', 'test')); //true
    myClass::test();

    ?>

    备注

    注意:

    使用此函数将使用任何已注册的 自动加载器（如果类尚不清楚）。

    注意:

    property_exists() 函数无法检测使用 __get 魔术方法进行魔术访问的属性。

    参见

    发现问题？

    了解如何改进此页面 • 提交拉取请求 • 报告错误
    ＋添加注释

    用户贡献的注释 6 条注释

    68
    g dot gentile at parentesigraffe dot com
    9 年前
    此函数的行为根据属性是在类声明中存在还是动态添加，以及变量是否已被 unset() 而有所不同。

    <?php

    类 TestClass {

    public     $declared = null;

    }

    $testObject = new TestClass;

    var_dump(property_exists("TestClass", "dynamic")); // 布尔值 false，符合预期
    var_dump(property_exists($testObject, "dynamic")); // 布尔值 false，与上面相同

    $testObject->dynamic = null;
    var_dump(property_exists($testObject, "dynamic")); // 布尔值 true

    unset($testObject->dynamic);
    var_dump(property_exists($testObject, "dynamic")); // 布尔值 false，再次出现。

    var_dump(property_exists($testObject, "declared")); // 布尔值 true，符合预期

    unset($testObject->declared);
    var_dump(property_exists($testObject, "declared")); // 布尔值 true，即使已被 unset()
    26
    Stefan W
    11 年前
    如果您在命名空间文件中，并且想要将类名作为字符串传递，则必须包含类名的完整命名空间 - 即使在同一个命名空间中也是如此。

    <?
    命名空间 MyNS;

    类 A {
    public $foo;
    }

    property_exists("A", "foo"); // false
    property_exists("\\MyNS\\A", "foo"); // true
    ?>
    14
    Nanhe Kumar
    10 年前
    <?php

    class 学生 {

    protected     $_姓名;
    protected     $_邮箱;


    public function     __call($名称, $参数) {
    $操作 = substr($名称, 0, 3);
    switch (    $操作) {
    case     'get':
    $属性 = '_' . strtolower(substr($名称, 3));
    if(    property_exists($this,$属性)){
    return     $this->{$属性};
    }else{
    echo     "未定义属性";
    }
    break;
    case     'set':
    $属性 = '_' . strtolower(substr($名称, 3));
    if(    property_exists($this,$属性)){
    $this->{$属性} = $参数[0];
    }else{
    echo     "未定义属性";
    }

    break;
    default :
    return     FALSE;
    }
    }

    }

    $s = new 学生();
    $s->set姓名('Nanhe Kumar');
    $s->set邮箱('[email protected]');
    echo     $s->get姓名(); //Nanhe Kumar
    echo $s->get邮箱(); // [email protected]
    $s->setAge(10); //未定义属性
    ?>
    6
    ewisuri [gmail]
    10 年前
    从 PHP 5.3.0 开始，从父类调用 property_exists 会看到子类中的私有属性。

    <?php
    class P {
    public function     test_prop($prop) { return property_exists($this, $prop); }
    }

    class     子类 extends P {
    private     $prop1;
    }

    $child = new 子类();
    var_dump($child->test_prop('prop1')); //true，从 PHP 5.3.0 开始
    4
    saurabh dot agarwal89 at gmail dot com
    9 年前
    $a = array('a','b'=>'c');
    print_r((object) $a);
    var_dump( property_exists((object) $a,'0'));
    var_dump( property_exists((object) $a,'b'));

    输出
    stdClass 对象
    (
    [0] => a
    [b] => c
    )
    bool(false)
    bool(true)
    -2
    biziclop
    1 年前
    我需要一种方法来确定在类外部访问属性是否可能不会出现错误/警告，考虑到该类可能会使用魔术方法 __isset/__get 来模拟不存在的属性。

    <?php
    // 如果属性可以通过 $obj->$prop 安全地公开访问，则返回 true
    // 在 PHP 5.1 - 8.2 上测试过，请参见 https://3v4l.org/QBTd1
    function public_property_exists( $obj, $prop ){
    // 允许执行魔术 $obj->__isset( $prop )（如果存在）
    if( isset( $obj->$prop )) return true;

    // 不存在具有此名称的公共/受保护/私有属性
    if( ! property_exists( $obj, $prop )) return false;

    // 属性存在，但它是公共的吗？
    $rp = new ReflectionProperty( $obj, $prop );
    return     $rp->isPublic();
    }

    //// 测试/演示
    class C {
    public     $public = "我是公开的！";
    protected     $protected = "我是公开的！";
    private     $private = "我是公开的！";
    function     __isset( $k ){
    return     substr( $k, 0, 5 ) === 'magic';
    }
    function     __get( $k ){
    if(     $k === 'magic_isset_but_null') return null;
    return     "我是 {$k}！";
    }
    }

    $o = new C();
    foreach( array(
    'public', 'protected', 'private',
    'magic', 'magic_isset_but_null',
    'missing'
    ) as $prop ){
    if(     public_property_exists( $o, $prop ))
    echo     "\$o->{$prop} 是一个公共属性，其值为：",
    var_export( $o->$prop, true ), "\n";
    else echo     "\$o->{$prop} 不是一个公共属性。\n";
    }
    /*
    $o->public 是一个公共属性，其值为：'I’m public!'
    $o->protected 不是一个公共属性。
    $o->private 不是一个公共属性。
    $o->magic 是一个公共属性，其值为：'I’m magic!'
    $o->magic_isset_but_null 是一个公共属性，其值为：NULL
    $o->missing 不是一个公共属性。
    */
    ＋添加注释
    To Top