PHP 日本大会 2024

    ReflectionClass 类

    (PHP 5, PHP 7, PHP 8)

    简介

    ReflectionClass 类报告有关类的信息。

    类概要

    class ReflectionClass implements Reflector {
    /* 常量 */
    public const int IS_IMPLICIT_ABSTRACT;
    public const int IS_EXPLICIT_ABSTRACT;
    public const int IS_FINAL;
    public const int IS_READONLY;
    public const int SKIP_INITIALIZATION_ON_SERIALIZE;
    public const int SKIP_DESTRUCTOR;
    /* 属性 */
    public string $name;
    /* 方法 */
    public __construct(object|string $objectOrClass)
    public static export(mixed $argument, bool $return = false): string
    public getAttributes(?string $name = null, int $flags = 0): array
    public getConstant(string $name): mixed
    public getConstants(?int $filter = null): array
    public getConstructor(): ?ReflectionMethod
    public getDefaultProperties(): array
    public getDocComment(): string|false
    public getEndLine(): int|false
    public getExtension(): ?ReflectionExtension
    public getExtensionName(): string|false
    public getFileName(): string|false
    public getInterfaceNames(): array
    public getInterfaces(): array
    public getLazyInitializer(object $object): ?callable
    public getMethod(string $name): ReflectionMethod
    public getMethods(?int $filter = null): array
    public getModifiers(): int
    public getName(): string
    public getNamespaceName(): string
    public getParentClass(): ReflectionClass|false
    public getProperties(?int $filter = null): array
    public getProperty(string $name): ReflectionProperty
    public getReflectionConstant(string $name): ReflectionClassConstant|false
    public getReflectionConstants(?int $filter = null): array
    public getShortName(): string
    public getStartLine(): int|false
    public getStaticProperties(): array
    public getStaticPropertyValue(string $name, mixed &$def_value = ?): mixed
    public getTraitAliases(): array
    public getTraitNames(): array
    public getTraits(): array
    public hasConstant(string $name): bool
    public hasMethod(string $name): bool
    public hasProperty(string $name): bool
    public implementsInterface(ReflectionClass|string $interface): bool
    public initializeLazyObject(object $object): object
    public inNamespace(): bool
    public isAbstract(): bool
    public isAnonymous(): bool
    public isCloneable(): bool
    public isEnum(): bool
    public isFinal(): bool
    public isInstance(object $object): bool
    public isInstantiable(): bool
    public isInterface(): bool
    public isInternal(): bool
    public isIterable(): bool
    public isReadOnly(): bool
    public isSubclassOf(ReflectionClass|string $class): bool
    public isTrait(): bool
    public isUninitializedLazyObject(object $object): bool
    public isUserDefined(): bool
    public markLazyObjectAsInitialized(object $object): object
    public newInstance(mixed ...$args): object
    public newInstanceArgs(array $args = []): ?object
    public newInstanceWithoutConstructor(): object
    public newLazyGhost(callable $initializer, int $options = 0): object
    public newLazyProxy(callable $factory, int $options = 0): object
    public resetAsLazyGhost(object $object, callable $initializer, int $options = 0): void
    public resetAsLazyProxy(object $object, callable $factory, int $options = 0): void
    public setStaticPropertyValue(string $name, mixed $value): void
    public __toString(): string
    }

    属性

    name

    类的名称。只读，尝试写入会抛出ReflectionException异常。

    预定义常量

    ReflectionClass 修饰符

    ReflectionClass::IS_IMPLICIT_ABSTRACT int

    指示该类由于具有某些抽象方法而为抽象类。

    ReflectionClass::IS_EXPLICIT_ABSTRACT int

    由于类的定义，它被指示为抽象类。

    ReflectionClass::IS_FINAL int

    指示该类为最终类。

    ReflectionClass::IS_READONLY int

    指示该类为只读类。

    ReflectionClass::SKIP_INITIALIZATION_ON_SERIALIZE int
    指示serialize()不应该触发延迟对象的初始化。
    ReflectionClass::SKIP_DESTRUCTOR int
    指示在将对象重置为延迟对象时，不应调用对象的析构函数。

    更新日志

    版本 描述
    8.4.0 类常量现在已进行类型声明。
    8.0.0 ReflectionClass::export() 已被移除。

    目录

    发现问题？

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

    用户贡献注释 4 条注释

    40
    danbettles at yahoo dot co dot uk
    15 年前
    要在 PHP 5.3 中反映命名空间类，必须始终指定类的完全限定名称 - 即使已使用“use”语句为包含的命名空间设置了别名。

    因此，不要使用

    <?php
    use App\Core as Core;
    $oReflectionClass = new ReflectionClass('Core\Singleton');
    ?>

    而应使用

    <?php
    use App\Core as Core;
    $oReflectionClass = new ReflectionClass('App\Core\Singleton');
    ?>
    25
    匿名用户
    13 年前
    反序列化的反射类会导致错误。

    <?php
    /**
    * abc
    */
    class a{}

    $ref = new ReflectionClass('a');
    $ref = unserialize(serialize($ref));
    var_dump($ref);
    var_dump($ref->getDocComment());

    // object(ReflectionClass)#2 (1) {
    // ["name"]=>
    // string(1) "a"
    // }
    // PHP Fatal error: ReflectionClass::getDocComment(): Internal error: Failed to retrieve the reflection object
    ?>
    21
    匿名用户
    11 年前
    反映别名将为您提供已解析类的反射。

    <?php

    class X {

    }

    class_alias('X','Y');
    class_alias('Y','Z');
    $z = new ReflectionClass('Z');
    echo     $z->getName(); // X

    ?>
    ＋添加注释
    To Top