/** * @param string $name * @param string $text */ protected function __construct($name, $text) { parent::__construct($name, $text); $text = trim($text); $parts = preg_split('~\\s+~', trim($text), 2); $this->type = Type::fromString($parts[0]); if (count($parts) >= 2) { $this->description = $parts[1] ?: null; } }
/** * @param Name|string $type * * @return Type */ private function getType($type) { return Type::fromString(Type::nameToString($type)); }
public function enterNode(Node $node) { if (!$node instanceof Stmt\Property) { $annotations = []; if ($node->hasAttribute('annotations')) { $annotations = $node->getAttribute('annotations'); } if (!empty($annotations['var'])) { foreach ($annotations['var'] as $varTag) { $name = $varTag->getIdentifier(); if (empty($name)) { $var = $node; if ($var instanceof Stmt\Foreach_) { $var = $var->valueVar; } elseif ($var instanceof Stmt\For_) { $var = $var->init; } elseif ($var instanceof Stmt\Global_ && count($var->vars) === 1) { $var = $var->vars[0]; } if ($var instanceof Expr\Assign || $var instanceof Expr\AssignRef || $var instanceof Expr\AssignOp) { $var = $var->var; } if ($var instanceof Expr\Variable && is_string($var->name)) { $name = '$' . $var->name; } } if (!empty($name)) { $this->getCurrentFunctionScope()[$name] = $varTag->getType(); } } } } if ($node instanceof Name) { $self = $this->getCurrentClass(); if (!empty($self) && !empty($self->getClass())) { $resolved = null; // Treating `static` as `self` is the best we can do here. if ($node->toString() === 'self' || $node->toString() === 'static') { $resolved = $self->getClass(); } elseif ($node->toString() === 'parent') { $selfClass = $this->reflection->findClass($self->getClass()); if (!empty($selfClass) && $selfClass[0] instanceof Class_ && !empty($selfClass[0]->getExtends())) { $resolved = $selfClass[0]->getExtends(); } } if (!empty($resolved)) { $node->setAttribute('resolved', new Name\FullyQualified(ltrim($resolved, '\\'), $node->getAttributes())); } } } elseif ($node instanceof Stmt\Function_) { $scope = []; $functions = $this->reflection->findFunction($node->hasAttribute('namespacedName') ? Type::nameToString($node->getAttribute('namespacedName')) : $node->name); if (!empty($functions)) { foreach ($functions[0]->getParams() as $param) { $scope[$param->getName()] = $param->getDocType(); } } $this->functionScopeStack[] = $scope; } elseif ($node instanceof Stmt\ClassMethod) { $scope = []; $class = $this->getCurrentClass(); if (!empty($class) && !empty($class->getClass())) { $method = $this->reflection->findMethod($class->getClass(), $node->name); if (!empty($method)) { foreach ($method->getParams() as $param) { $scope[$param->getName()] = $param->getDocType(); } } } $this->functionScopeStack[] = $scope; } elseif ($node instanceof Expr\Closure) { $scope = []; $parentScope =& $this->getCurrentFunctionScope(); foreach ($node->uses as $use) { if (array_key_exists('$' . $use->var, $parentScope)) { $scope['$' . $use->var] = $parentScope['$' . $use->var]; } } foreach ($node->params as $param) { $scope['$' . $param->name] = Type::fromString(Type::nameToString($param->type)); } $this->functionScopeStack[] = $scope; } elseif ($node instanceof Stmt\ClassLike) { $className = $node->hasAttribute('namespacedName') ? Type::nameToString($node->getAttribute('namespacedName')) : $node->name; $this->classStack[] = Type::object_($className); // for isolation, in case of illegal statements in class def: $this->functionScopeStack[] = []; } }
protected function getType($typeString) { if (array_key_exists($typeString, static::TYPE_ALIASES)) { $typeString = static::TYPE_ALIASES[$typeString]; } return empty($typeString) ? Type::mixed_() : Type::fromString($typeString); }