. * */ namespace OC\AppFramework\Utility; /** * Reads and parses annotations from doc comments */ class ControllerMethodReflector { private $annotations; private $types; private $parameters; public function __construct() { $this->types = array(); $this->parameters = array(); $this->annotations = array(); } /** * @param object $object an object or classname * @param string $method the method which we want to inspect */ public function reflect($object, $method){ $reflection = new \ReflectionMethod($object, $method); $docs = $reflection->getDocComment(); // extract everything prefixed by @ and first letter uppercase preg_match_all('/@([A-Z]\w+)/', $docs, $matches); $this->annotations = $matches[1]; // extract type parameter information preg_match_all('/@param (?\w+) \$(?\w+)/', $docs, $matches); $this->types = array_combine($matches['var'], $matches['type']); // get method parameters foreach ($reflection->getParameters() as $param) { $this->parameters[] = $param->name; } } /** * Inspects the PHPDoc parameters for types * @param strint $parameter the parameter whose type comments should be * parsed * @return string type in the type parameters (@param int $something) would * return int */ public function getType($parameter) { return $this->types[$parameter]; } /** * @return array the arguments of the method */ public function getParameters() { return $this->parameters; } /** * Check if a method contains an annotation * @param string $name the name of the annotation * @return bool true if the annotation is found */ public function hasAnnotation($name){ return in_array($name, $this->annotations); } }