name: Name of the property. Read-only, throws ReflectionException in attempt to write.
class: Name of the class where the property is defined. Read-only, throws ReflectionException in attempt to write.

Predefined Constants

ReflectionProperty Modifiers

ReflectionProperty::IS_STATIC int: Indicates static properties. Prior to PHP 7.4.0, the value was 1.
ReflectionProperty::IS_READONLY int: Indicates readonly properties. Available as of PHP 8.1.0.
ReflectionProperty::IS_PUBLIC int: Indicates public properties. Prior to PHP 7.4.0, the value was 256.
ReflectionProperty::IS_PROTECTED int: Indicates protected properties. Prior to PHP 7.4.0, the value was 512.
ReflectionProperty::IS_PRIVATE int: Indicates private properties. Prior to PHP 7.4.0, the value was 1024.
ReflectionProperty::IS_ABSTRACT int: Indicates the property is abstract. Available as of PHP 8.4.0.
ReflectionProperty::IS_PROTECTED_SET int: Available as of PHP 8.4.0.
ReflectionProperty::IS_PRIVATE_SET int: Available as of PHP 8.4.0.
ReflectionProperty::IS_VIRTUAL int: Available as of PHP 8.4.0.
ReflectionProperty::IS_FINAL int: Indicates the property is final. Available as of PHP 8.4.0.

Note:
The values of these constants may change between PHP versions. It is recommended to always use the constants and not rely on the values directly.

Changelog

Version	Description
8.4.0	The class constants are now typed.
8.4.0	Added `ReflectionProperty::IS_VIRTUAL`, `ReflectionProperty::IS_PRIVATE_SET`, `ReflectionProperty::IS_PROTECTED_SET`, `ReflectionProperty::IS_ABSTRACT`, and `ReflectionProperty::IS_FINAL`.
8.0.0	ReflectionProperty::export() was removed.

ReflectionProperty::__clone — Clone
ReflectionProperty::__construct — Construct a ReflectionProperty object
ReflectionProperty::export — Export
ReflectionProperty::getAttributes — Gets Attributes
ReflectionProperty::getDeclaringClass — Gets declaring class
ReflectionProperty::getDefaultValue — Returns the default value declared for a property
ReflectionProperty::getDocComment — Gets the property doc comment
ReflectionProperty::getHook — Returns a reflection object for a specified hook
ReflectionProperty::getHooks — Returns an array of all hooks on this property
ReflectionProperty::getModifiers — Gets the property modifiers
ReflectionProperty::getName — Gets property name
ReflectionProperty::getRawValue — Returns the value of a property, bypassing a get hook if defined
ReflectionProperty::getSettableType — Returns the parameter type of a setter hook
ReflectionProperty::getType — Gets a property's type
ReflectionProperty::getValue — Gets value
ReflectionProperty::hasDefaultValue — Checks if property has a default value declared
ReflectionProperty::hasHook — Returns whether the property has a given hook defined
ReflectionProperty::hasHooks — Returns whether the property has any hooks defined
ReflectionProperty::hasType — Checks if property has a type
ReflectionProperty::isAbstract — Determines if a property is abstract
ReflectionProperty::isDefault — Checks if property is a default property
ReflectionProperty::isDynamic — Checks if property is a dynamic property
ReflectionProperty::isFinal — Determines if this property is final or not
ReflectionProperty::isInitialized — Checks whether a property is initialized
ReflectionProperty::isLazy — Checks whether a property is lazy
ReflectionProperty::isPrivate — Checks if property is private
ReflectionProperty::isPrivateSet — Checks if property is private for writing
ReflectionProperty::isPromoted — Checks if property is promoted
ReflectionProperty::isProtected — Checks if property is protected
ReflectionProperty::isProtectedSet — Checks whether the property is protected for writing
ReflectionProperty::isPublic — Checks if property is public
ReflectionProperty::isReadOnly — Checks if property is readonly
ReflectionProperty::isStatic — Checks if property is static
ReflectionProperty::isVirtual — Determines if a property is virtual
ReflectionProperty::setAccessible — Set property accessibility
ReflectionProperty::setRawValue — Sets the value of a property, bypassing a set hook if defined
ReflectionProperty::setRawValueWithoutLazyInitialization — Set raw property value without triggering lazy initialization
ReflectionProperty::setValue — Set property value
ReflectionProperty::skipLazyInitialization — Marks property as non-lazy
ReflectionProperty::__toString — To string

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 2 notes

down

rasmus at mindplay dot dk ¶

14 years ago

I think a more accurate explanation is this:

The Reflection classes are designed to reflect upon the source code of an application, not on any runtime information.

I think you misunderstand the ReflectionProperty constructor in your example above. The fact that it accepts an object as argument is just a convenience feature - you are actually inspecting the class of that object, not the object itself, so it's basically equivalent to:

<?php

// works fine 
$Reflection = new ReflectionProperty(get_class($a), 'a');

// throws exception 
$Reflection = new ReflectionProperty(get_class($a), 'foo');

?>

Getting the class of the object you're passing in is implied, since inspecting a defined property is the purpose of this class.

In your example, $a->foo is a dynamic member - it is not defined as a member of class, so there is no defining class reference, line number, default value, etc. - which means, there is nothing to reflect upon.

Clearly this very useful library could use some real documentation...

down

mitgath at gmail dot com ¶

1 day ago

There is way to get property type without reflection.
Not very clear, but there is:

<?php

function getPropType(object $object, string $propName): string
{
    try {
        $object->{$propName} = new class {};
    } catch (\TypeError $e) {
        // @hint: question mark in type can be used to detect if property is nullable
        if (preg_match('/of type \??(.*)$/', $e->getMessage(), $m)) {
            return $m[1];
        }
        throw $e;
    } catch (\Error $e) {
        // property doesn't exist or is not public
        throw $e;
    }
    throw new \TypeError(sprintf('Property %s of class %s has no type', $propName, $object::class));
    // alternatively return 'mixed';
}
?>

note: in case you need access to private/protected properties its easy to change this to be embedded in any class:

<?php

trait PropertyTypeResolver
{
    public function getPropType(string $propName): string
    {
        try {
            $this->{$propName} = new class {};
        } catch (\TypeError $e) {
            // @hint: question mark in type can be used to detect if property is nullable
            if (preg_match('/of type \??(.*)$/', $e->getMessage(), $m)) {
                return $m[1];
            }
            throw $e;
        } catch (\Error $e) {
            // property doesn't exist
            throw $e;
        }
        throw new \TypeError(sprintf('Property %s of class %s has no type', $propName, $this::class));
        // alternatively return 'mixed';
    }
}
?>

＋add a note

The ReflectionProperty class

Introduction

Class synopsis

Properties

Predefined Constants

ReflectionProperty Modifiers

Changelog

Table of Contents

Found A Problem?

User Contributed Notes 2 notes