• 首页
  • vue
  • TypeScript
  • JavaScript
  • scss
  • css3
  • html5
  • php
  • MySQL
  • redis
  • jQuery
  • ReflectionClass::__construct()

    (PHP 5, PHP 7)

    初始化 ReflectionClass 类

    说明

    publicReflectionClass::__construct(mixed $argument)

    初始化新的ReflectionClass对象。

    参数

    $argument

    既可以是包含类名的字符串(string)也可以是对象(object)。

    返回值

    返回初始化完成后的ReflectionClass实例。

    错误/异常

    如果要反射的 Class 不存在,抛出异常ReflectionException。

    范例

    ReflectionClass 的基本用法

    <?php
    Reflection::export(new ReflectionClass('Exception'));
    ?>
    

    以上例程的输出类似于:

    Class [ <internal:Core> class Exception ] {
      - Constants [0] {
      }
      - Static properties [0] {
      }
      - Static methods [0] {
      }
      - Properties [7] {
        Property [ <default> protected $message ]
        Property [ <default> private $string ]
        Property [ <default> protected $code ]
        Property [ <default> protected $file ]
        Property [ <default> protected $line ]
        Property [ <default> private $trace ]
        Property [ <default> private $previous ]
      }
      - Methods [10] {
        Method [ <internal:Core> final private method __clone ] {
        }
        Method [ <internal:Core, ctor> public method __construct ] {
          - Parameters [3] {
            Parameter #0 [ <optional> $message ]
            Parameter #1 [ <optional> $code ]
            Parameter #2 [ <optional> $previous ]
          }
        }
        Method [ <internal:Core> final public method getMessage ] {
        }
        Method [ <internal:Core> final public method getCode ] {
        }
        Method [ <internal:Core> final public method getFile ] {
        }
        Method [ <internal:Core> final public method getLine ] {
        }
        Method [ <internal:Core> final public method getTrace ] {
        }
        Method [ <internal:Core> final public method getPrevious ] {
        }
        Method [ <internal:Core> final public method getTraceAsString ] {
        }
        Method [ <internal:Core> public method __toString ] {
        }
      }
    }
    

    参见

    • ReflectionObject::__construct() Constructs a ReflectionObject
    • Constructors
    To reflect on a namespaced class in PHP 5.3, you must always specify the fully qualified name of the class - even if you've aliased the containing namespace using a "use" statement. 
    So instead of: 
    <?php 
    use App\Core as Core; 
    $oReflectionClass = new ReflectionClass('Core\Singleton'); 
    ?> 
    You would type: 
    <?php 
    use App\Core as Core; 
    $oReflectionClass = new ReflectionClass('App\Core\Singleton'); 
    ?>
    
    Example of usage:
      public static function getClassData($class)
      {
        // Trying to create a new object of ReflectionClass class
        $class = new ReflectionClass($class);
        $details = sprintf('%s - %s%s%s%s%s%s%s%s',
          $class->getName(),
          $class->isInternal()   ? 'internal class,' : 'user-defined class,',
          $class->isTrait()    ? ' is trait,' : '',
          $class->isInterface()  ? ' is interface,' : '',
          $class->isAbstract()   ? ' is abstract,' : '',
          $class->isFinal()    ? ' is final,' : '',
          $class->isCloneable()  ? ' is cloneable,' : '',
          $class->isInstantiable() ? ' is instantiable,' : '',
          $class->isIterateable() ? ' is iterable : ''
        );
        return '<pre class="debug">' . rtrim($details, ',') . '</pre>';
      }
    Running the following code on Windows Vista (I know, I know), PHP 5.3.9, the ReflectionClass constructor actually throws a ReflectionException when the desired class cannot be instantiated:
    <?php
      try {
        $ReflectedClass = new ReflectionClass('NonExist');
      } catch (LogicException $Exception) {
        die('Not gonna make it in here...');
      } catch (ReflectionException $Exception) {
        die('Your class does not exist!');
      }
    ?>
    
    It's very useful to know that you can also use the ReflectionClass to inspect interfaces, even thouth Interfaces are not classes. Example:
    <?php
     interface Edible
     {
      public function eat();
     }
     $refl = new ReflectionClass("Edible");
     $methods = $refl->getMethods();
    ?>
    [Edit by danbrown AT php DOT net - Contains a bugfix by (dbl AT bnet DOT com) on 18-AUG-2010 with the following message: "underline had to be removed for it to work ( new Reflection_Class -> new ReflectionClass )"]
    Useful to know that if you pass a string into the construct and the class cannot be instantiated for some reason a SPL LogicException will be thrown. 
    This code was ran on a Mac OS X 10.6.7, AMP, PHP 5.3+
    <?php
      // index.php
      try {
        $ReflectedClass = new ReflectionClass('NonExist');
      } catch (LogicException $logicDuh) {
        print_r($logicDuh);
      }
      
    ?>
    Will return a deeply nested array full of useful information about the error.
    if (is_file($classfile))
          require_once $classfile;
    if (! class_exists($classname, false))
          exit('ERROR: ' . $classname . ' is not defined as a Class');
    The above code is useful to tell if the class was defined. You could also use another commentors method using Try Catch Exceptions. But, if you do not use try blocks much, the above function based method works just fine.
    From there, you can than call:
    $class = new ReflectionClass($classname);
        if (! $class->isSubclassOf('PanelCommon'))
          exit("ERROR: {$classname} must extends PanelCommon");
        if (! $class->isUserDefined())
          exit("ERROR: {$classname} must be user defined and not internal to PHP");
        if (! $class->IsInstantiable())
          exit("ERROR: {$classname} must be IsInstantiable and not an Interface or Abstract class");
        if (! $class->hasMethod('home'))
          exit("ERROR: {$classname} lacks required method/function home()");
    Forforth and so on.