百木园2022年3月9日09:21:06
之前就有人利用phpdoc实现了注解，但是性能一般，现在php8也追加了注解，现在8.1的fiber也加入了，未来PHP异步编程也趋于完善，剩下就是泛型的加入了，就fb的hacklang类似的语言
原理和java的注解基本一致，使用起来比java简单
基本使用就是在类或者方法上挂载注解，在注解里面注入一些参数，然后使用反射类，去反射被挂在注解的类或者方法的参数，在注解类里面去执行一些方法，一般都会配合aop编程在实现自动执行
aop就是自动扫描挂在注解的方法所在的文件或者文件路径
比如在controller上挂在路由，估计PHP注解开始大面积使用的时候，对应的aop包也会一起出现
基本使用
注解类 注解类也是可以继承的
#[Attribute(Attribute::TARGET_ALL)]
class father
{
private string $path;
private string $method;
public function __construct(string $path, string $method = \'GET\')
{
$this->path = $path;
$this->method = $method;
}
public function getPath()
{
return $this->path;
}
public function getMethod()
{
return $this->method;
}
}
在类上面挂载注解
<?php
include_once \'./zx.php\';
#[father(\'/data\', \'POST\')]
class tt
{
#[father(\'/post\', \'POST\')]
public function postName()
{
}
#[father(\'/get\', \'GET\')]
public function getName()
{
}
}
通过aop扫表所有使用注解的类，其实就是psr4标准，类的空间命名，去扫描对应的目录，吧文件的所有类通过反射获取对应值，然后执行某些操作，aop类就不写了，直接写反射的具体类容
$rc = new ReflectionClass(tt::class);
$r_atts = $rc->getAttributes(father::class);
//因为可能出现 IS_REPEATABLE 默认不能重复挂载注解，加上这个就是可以重复挂在
//print_r($r_atts[\'0\']->getName());
$f_path = $r_atts[\'0\']->getName();
print_r($f_path);
print_r(PHP_EOL);
print_r($r_atts[\'0\']->newInstance()->getPath());
print_r(PHP_EOL);
//获取子目录的
$rr = $rc->getMethods();
foreach ($rr as $k => $v) {
print_r($v->getName());
print_r(PHP_EOL);
foreach ($v->getAttributes() as $kk => $vv) {
print_r($vv->getName());
print_r(PHP_EOL);
// print_r($vv->getArguments());
print_r($vv->newInstance()->getPath());
print_r(PHP_EOL);
}
}
PS D:\\phpstudy_pro\\WWW\\www.kk.com> php80 .\\index.php father /data postName father /post getName father /get
这样就是吧path拼接完整的path，写入到路由表里
php原始的属性注解
#[Attribute(Attribute::TARGET_CLASS)]
final class Attribute
{
public int $flags;
/**
* Marks that attribute declaration is allowed only in classes.
*/
public const TARGET_CLASS = 1;
/**
* Marks that attribute declaration is allowed only in functions.
*/
public const TARGET_FUNCTION = 2;
/**
* Marks that attribute declaration is allowed only in class methods.
*/
public const TARGET_METHOD = 4;
/**
* Marks that attribute declaration is allowed only in class properties.
*/
public const TARGET_PROPERTY = 8;
/**
* Marks that attribute declaration is allowed only in class constants.
*/
public const TARGET_CLASS_CONSTANT = 16;
/**
* Marks that attribute declaration is allowed only in function or method parameters.
*/
public const TARGET_PARAMETER = 32;
/**
* Marks that attribute declaration is allowed anywhere.
*/
public const TARGET_ALL = 63;
/**
* Notes that an attribute declaration in the same place is
* allowed multiple times.
*/
public const IS_REPEATABLE = 64;
/**
* @param int $flags A value in the form of a bitmask indicating the places
* where attributes can be defined.
*/
public function __construct(#[ExpectedValues(flagsFromClass: Attribute::class)] int $flags = self::TARGET_ALL) {}
}
class ReflectionClass implements Reflector
{
/**
* @var string Name of the class, same as calling the {@see ReflectionClass::getName()} method
*/
#[Immutable]
public $name;
/**
* Indicates class that is abstract because it has some abstract methods.
*
* @link https://www.php.net/manual/en/class.reflectionclass.php#reflectionclass.constants.is-implicit-abstract
*/
public const IS_IMPLICIT_ABSTRACT = 16;
/**
* Indicates class that is abstract because of its definition.
*
* @link https://www.php.net/manual/en/class.reflectionclass.php#reflectionclass.constants.is-explicit-abstract
*/
public const IS_EXPLICIT_ABSTRACT = 64;
/**
* Indicates final class.
*
* @link https://www.php.net/manual/en/class.reflectionclass.php#reflectionclass.constants.is-final
*/
public const IS_FINAL = 32;
/**
* Constructs a ReflectionClass
*
* @link https://php.net/manual/en/reflectionclass.construct.php
* @param string|object $objectOrClass Either a string containing the name of
* the class to reflect, or an object.
* @throws \\ReflectionException if the class does not exist.
*/
public function __construct($objectOrClass) {}
/**
* Exports a reflected class
*
* @link https://php.net/manual/en/reflectionclass.export.php
* @param mixed $argument The reflection to export.
* @param bool $return Setting to {@see true} will return the export, as
* opposed to emitting it. Setting to {@see false} (the default) will do the opposite.
* @return string|null If the $return parameter is set to {@see true}, then the
* export is returned as a string, otherwise {@see null} is returned.
* @removed 8.0
*/
#[Deprecated(since: \'7.4\')]
public static function export($argument, $return = false) {}
/**
* Returns the string representation of the ReflectionClass object.
*
* @link https://php.net/manual/en/reflectionclass.tostring.php
* @return string A string representation of this {@see ReflectionClass} instance.
*/
public function __toString() {}
/**
* Gets class name
*
* @link https://php.net/manual/en/reflectionclass.getname.php
* @return string The class name.
*/
#[Pure]
public function getName() {}
/**
* Checks if class is defined internally by an extension, or the core
*
* @link https://php.net/manual/en/reflectionclass.isinternal.php
* @return bool Returns {@see true} on success or {@see false} on failure.
*/
#[Pure]
public function isInternal() {}
/**
* Checks if user defined
*
* @link https://php.net/manual/en/reflectionclass.isuserdefined.php
* @return bool Returns {@see true} on success or {@see false} on failure.
*/
#[Pure]
public function isUserDefined() {}
/**
* Checks if the class is instantiable
*
* @link https://php.net/manual/en/reflectionclass.isinstantiable.php
* @return bool Returns {@see true} on success or {@see false} on failure.
*/
#[Pure]
public function isInstantiable() {}
/**
* Returns whether this class is cloneable
*
* @link https://php.net/manual/en/reflectionclass.iscloneable.php
* @return bool Returns {@see true} if the class is cloneable, {@see false} otherwise.
* @since 5.4
*/
#[Pure]
public function isCloneable() {}
/**
* Gets the filename of the file in which the class has been defined
*
* @link https://php.net/manual/en/reflectionclass.getfilename.php
* @return string|false the filename of the file in which the class has been defined.
* If the class is defined in the PHP core or in a PHP extension, {@see false}
* is returned.
*/
#[Pure]
public function getFileName() {}
/**
* Gets starting line number
*
* @link https://php.net/manual/en/reflectionclass.getstartline.php
* @return int The starting line number, as an integer.
*/
#[Pure]
public function getStartLine() {}
/**
* Gets end line
*
* @link https://php.net/manual/en/reflectionclass.getendline.php
* @return int|false The ending line number of the user defined class, or
* {@see false} if unknown.
*/
#[Pure]
public function getEndLine() {}
/**
* Gets doc comments
*
* @link https://php.net/manual/en/reflectionclass.getdoccomment.php
* @return string|false The doc comment if it exists, otherwise {@see false}
*/
#[Pure]
public function getDocComment() {}
/**
* Gets the constructor of the class
*
* @link https://php.net/manual/en/reflectionclass.getconstructor.php
* @return ReflectionMethod|null A {@see ReflectionMethod} object reflecting
* the class\' constructor, or {@see null} if the class has no constructor.
*/
#[Pure]
public function getConstructor() {}
/**
* Checks if method is defined
*
* @link https://php.net/manual/en/reflectionclass.hasmethod.php
* @param string $name Name of the method being checked for.
* @return bool Returns {@see true} if it has the method, otherwise {@see false}
*/
public function hasMethod($name) {}
/**
* Gets a <b>ReflectionMethod</b> for a class method.
*
* @link https://php.net/manual/en/reflectionclass.getmethod.php
* @param string $name The method name to reflect.
* @return ReflectionMethod A {@see ReflectionMethod}
* @throws \\ReflectionException if the method does not exist.
*/
#[Pure]
public function getMethod($name) {}
/**
* Gets an array of methods for the class.
*
* @link https://php.net/manual/en/reflectionclass.getmethods.php
* @param int|null $filter Filter the results to include only methods
* with certain attributes. Defaults to no filtering.
* @return ReflectionMethod[] An array of {@see ReflectionMethod} objects
* reflecting each method.
*/
#[Pure]
public function getMethods($filter = null) {}
/**
* Checks if property is defined
*
* @link https://php.net/manual/en/reflectionclass.hasproperty.php
* @param string $name Name of the property being checked for.
* @return bool Returns {@see true} if it has the property, otherwise {@see false}
*/
public function hasProperty($name) {}
/**
* Gets a <b>ReflectionProperty</b> for a class\'s property
*
* @link https://php.net/manual/en/reflectionclass.getproperty.php
* @param string $name The property name.
* @return ReflectionProperty A {@see ReflectionProperty}
* @throws ReflectionException If no property exists by that name.
*/
#[Pure]
public function getProperty($name) {}
/**
* Gets properties
*
* @link https://php.net/manual/en/reflectionclass.getproperties.php
* @param int|null $filter The optional filter, for filtering desired
* property types. It\'s configured using the {@see ReflectionProperty} constants,
* and defaults to all property types.
* @return ReflectionProperty[]
*/
#[Pure]
public function getProperties($filter = null) {}
/**
* Gets a ReflectionClassConstant for a class\'s property
*
* @link https://php.net/manual/en/reflectionclass.getreflectionconstant.php
* @param string $name The class constant name.
* @return ReflectionClassConstant A {@see ReflectionClassConstant}.
* @since 7.1
*/
#[Pure]
public function getReflectionConstant(string $name) {}
/**
* Gets class constants
*
* @link https://php.net/manual/en/reflectionclass.getreflectionconstants.php
* @param int|null $filter [optional] allows the filtering of constants defined in a class by their visibility. Since 8.0.
* @return ReflectionClassConstant[] An array of ReflectionClassConstant objects.
* @since 7.1
*/
#[Pure]
public function getReflectionConstants(?int $filter = ReflectionClassConstant::IS_PUBLIC|ReflectionClassConstant::IS_PROTECTED|ReflectionClassConstant::IS_PRIVATE) {}
/**
* Checks if constant is defined
*
* @link https://php.net/manual/en/reflectionclass.hasconstant.php
* @param string $name The name of the constant being checked for.
* @return bool Returns {@see true} if the constant is defined, otherwise {@see false}
*/
public function hasConstant($name) {}
/**
* Gets constants
*
* @link https://php.net/manual/en/reflectionclass.getconstants.php
* @param int $filter [optional] allows the filtering of constants defined in a class by their visibility. Since 8.0.
* @return array An array of constants, where the keys hold the name and
* the values the value of the constants.
*/
#[Pure]
public function getConstants($filter = ReflectionClassConstant::IS_PUBLIC|ReflectionClassConstant::IS_PROTECTED|ReflectionClassConstant::IS_PRIVATE) {}
/**
* Gets defined constant
*
* @link https://php.net/manual/en/reflectionclass.getconstant.php
* @param string $name Name of the constant.
* @return mixed|false Value of the constant with the name name.
* Returns {@see false} if the constant was not found in the class.
*/
#[Pure]
public function getConstant($name) {}
/**
* Gets the interfaces
*
* @link https://php.net/manual/en/reflectionclass.getinterfaces.php
* @return ReflectionClass[] An associative array of interfaces, with keys as interface
* names and the array values as {@see ReflectionClass} objects.
*/
#[Pure]
public function getInterfaces() {}
/**
* Gets the interface names
*
* @link https://php.net/manual/en/reflectionclass.getinterfacenames.php
* @return string[] A numerical array with interface names as the values.
*/
#[Pure]
public function getInterfaceNames() {}
/**
* Checks if the class is anonymous
*
* @link https://php.net/manual/en/reflectionclass.isanonymous.php
* @return bool Returns {@see true} on success or {@see false} on failure.
* @since 7.0
*/
#[Pure]
public function isAnonymous() {}
/**
* Checks if the class is an interface
*
* @link https://php.net/manual/en/reflectionclass.isinterface.php
* @return bool Returns {@see true} on success or {@see false} on failure.
*/
#[Pure]
public function isInterface() {}
/**
* Returns an array of traits used by this class
*
* @link https://php.net/manual/en/reflectionclass.gettraits.php
* @return ReflectionClass[]|null an array with trait names in keys and
* instances of trait\'s {@see ReflectionClass} in values.
* Returns {@see null} in case of an error.
* @since 5.4
*/
#[Pure]
public function getTraits() {}
/**
* Returns an array of names of traits used by this class
*
* @link https://php.net/manual/en/reflectionclass.gettraitnames.php
* @return string[] An array with trait names in values.
* Returns {@see null} in case of an error.
* @since 5.4
*/
#[Pure]
public function getTraitNames() {}
/**
* Returns an array of trait aliases
*
* @link https://php.net/manual/en/reflectionclass.gettraitaliases.php
* @return string[] an array with new method names in keys and original
* names (in the format \"TraitName::original\") in values.
* Returns {@see null} in case of an error.
* @since 5.4
*/
#[Pure]
public function getTraitAliases() {}
/**
* Returns whether this is a trait
*
* @link https://php.net/manual/en/reflectionclass.istrait.php
* @return bool Returns {@see true} if this is a trait, {@see false} otherwise.
* Returns {@see null} in case of an error.
* @since 5.4
*/
#[Pure]
public function isTrait() {}
/**
* Checks if class is abstract
*
* @link https://php.net/manual/en/reflectionclass.isabstract.php
* @return bool Returns {@see true} on success or {@see false} on failure.
*/
#[Pure]
public function isAbstract() {}
/**
* Checks if class is final
*
* @link https://php.net/manual/en/reflectionclass.isfinal.php
* @return bool Returns {@see true} on success or {@see false} on failure.
*/
#[Pure]
public function isFinal() {}
/**
* Gets modifiers
*
* @link https://php.net/manual/en/reflectionclass.getmodifiers.php
* @return int bitmask of modifier constants.
*/
#[Pure]
public function getModifiers() {}
/**
* Checks class for instance
*
* @link https://php.net/manual/en/reflectionclass.isinstance.php
* @param object $object The object being compared to.
* @return bool Returns {@see true} on success or {@see false} on failure.
*/
#[Pure]
public function isInstance($object) {}
/**
* Creates a new class instance from given arguments.
*
* @link https://php.net/manual/en/reflectionclass.newinstance.php
* @param mixed ...$args Accepts a variable number of arguments which are
* passed to the class constructor, much like {@see call_user_func}
* @return object a new instance of the class.
* @throws ReflectionException if the class constructor is not public or if
* the class does not have a constructor and the $args parameter contains
* one or more parameters.
*/
public function newInstance(...$args) {}
/**
* Creates a new class instance without invoking the constructor.
*
* @link https://php.net/manual/en/reflectionclass.newinstancewithoutconstructor.php
* @return object a new instance of the class.
* @throws ReflectionException if the class is an internal class that
* cannot be instantiated without invoking the constructor. In PHP 5.6.0
* onwards, this exception is limited only to internal classes that are final.
* @since 5.4
*/
public function newInstanceWithoutConstructor() {}
/**
* Creates a new class instance from given arguments.
*
* @link https://php.net/manual/en/reflectionclass.newinstanceargs.php
* @param array $args The parameters to be passed to the class constructor as an array.
* @return object a new instance of the class.
* @throws ReflectionException if the class constructor is not public or if
* the class does not have a constructor and the $args parameter contains
* one or more parameters.
* @since 5.1.3
*/
public function newInstanceArgs(array $args = []) {}
/**
* Gets parent class
*
* @link https://php.net/manual/en/reflectionclass.getparentclass.php
* @return ReflectionClass|false A {@see ReflectionClass} or {@see false}
* if there\'s no parent.
*/
#[Pure]
public function getParentClass() {}
/**
* Checks if a subclass
*
* @link https://php.net/manual/en/reflectionclass.issubclassof.php
* @param string|ReflectionClass $class Either the name of the class as
* string or a {@see ReflectionClass} object of the class to check against.
* @return bool {@see true} on success or {@see false} on failure.
*/
#[Pure]
public function isSubclassOf($class) {}
/**
* Gets static properties
*
* @link https://php.net/manual/en/reflectionclass.getstaticproperties.php
* @return mixed[] The static properties, as an array where the keys hold
* the name and the values the value of the properties.
*/
#[Pure]
public function getStaticProperties() {}
/**
* Gets static property value
*
* @link https://php.net/manual/en/reflectionclass.getstaticpropertyvalue.php
* @param string $name The name of the static property for which to return a value.
* @param mixed $default A default value to return in case the class does
* not declare a static property with the given name. If the property does
* not exist and this argument is omitted, a {@see ReflectionException} is thrown.
* @return mixed The value of the static property.
*/
#[Pure]
public function getStaticPropertyValue($name, $default = null) {}
/**
* Sets static property value
*
* @link https://php.net/manual/en/reflectionclass.setstaticpropertyvalue.php
* @param string $name Property name.
* @param mixed $value New property value.
* @return void No value is returned.
*/
public function setStaticPropertyValue($name, $value) {}
/**
* Gets default properties
*
* @link https://php.net/manual/en/reflectionclass.getdefaultproperties.php
* @return mixed[] An array of default properties, with the key being the name
* of the property and the value being the default value of the property
* or {@see null} if the property doesn\'t have a default value. The function
* does not distinguish between static and non static properties and does
* not take visibility modifiers into account.
*/
#[Pure]
public function getDefaultProperties() {}
/**
* An alias of {@see ReflectionClass::isIterable} method.
*
* @link https://php.net/manual/en/reflectionclass.isiterateable.php
* @return bool Returns {@see true} on success or {@see false} on failure.
*/
#[Pure]
public function isIterateable() {}
/**
* Check whether this class is iterable
*
* @link https://php.net/manual/en/reflectionclass.isiterable.php
* @return bool Returns {@see true} on success or {@see false} on failure.
* @since 7.2
*/
#[Pure]
public function isIterable() {}
/**
* Checks whether it implements an interface.
*
* @link https://php.net/manual/en/reflectionclass.implementsinterface.php
* @param string $interface The interface name.
* @return bool Returns {@see true} on success or {@see false} on failure.
*/
public function implementsInterface($interface) {}
/**
* Gets a <b>ReflectionExtension</b> object for the extension which defined the class
*
* @link https://php.net/manual/en/reflectionclass.getextension.php
* @return ReflectionExtension A {@see ReflectionExtension} object representing
* the extension which defined the class, or {@see null} for user-defined classes.
*/
#[Pure]
public function getExtension() {}
/**
* Gets the name of the extension which defined the class
*
* @link https://php.net/manual/en/reflectionclass.getextensionname.php
* @return string|false The name of the extension which defined the class,
* or {@see false} for user-defined classes.
*/
#[Pure]
public function getExtensionName() {}
/**
* Checks if in namespace
*
* @link https://php.net/manual/en/reflectionclass.innamespace.php
* @return bool {@see true} on success or {@see false} on failure.
*/
public function inNamespace() {}
/**
* Gets namespace name
*
* @link https://php.net/manual/en/reflectionclass.getnamespacename.php
* @return string The namespace name.
*/
#[Pure]
public function getNamespaceName() {}
/**
* Gets short name
*
* @link https://php.net/manual/en/reflectionclass.getshortname.php
* @return string The class short name.
*/
#[Pure]
public function getShortName() {}
/**
* Returns an array of function attributes.
*
* @param string|null $name Name of an attribute class
* @param int $flags Сriteria by which the attribute is searched.
* @return ReflectionAttribute[]
* @since 8.0
*/
#[Pure]
public function getAttributes(?string $name = null, int $flags = 0) {}
/**
* Clones object
*
* @link https://php.net/manual/en/reflectionclass.clone.php
* @return void
*/
final private function __clone() {}
}
来源：https://www.cnblogs.com/zx-admin/p/15983550.html
本站部分图文来源于网络，如有侵权请联系删除。