public static fromNode ( |
||
$context | The context in which the node appears | |
$code_base | ||
$node | ast\Node\Decl | An AST node representing a function |
$fqsen | A fully qualified name for the function | |
return | A Func representing the AST node in the given context |
/** * Visit a node with kind `\ast\AST_FUNC_DECL` * * @param Node $node * A node to parse * * @return Context * A new or an unchanged context resulting from * parsing the node */ public function visitFuncDecl(Decl $node) : Context { $function_name = (string) $node->name; // Hunt for an un-taken alternate ID $alternate_id = 0; $function_fqsen = null; do { $function_fqsen = FullyQualifiedFunctionName::fromStringInContext($function_name, $this->context)->withNamespace($this->context->getNamespace())->withAlternateId($alternate_id++); } while ($this->code_base->hasFunctionWithFQSEN($function_fqsen)); $func = Func::fromNode($this->context->withLineNumberStart($node->lineno ?? 0)->withLineNumberEnd($node->endLineno ?? 0), $this->code_base, $node, $function_fqsen); $this->code_base->addFunction($func); // Send the context into the function and reset the scope $context = $this->context->withScope($func->getInternalScope()); return $context; }
/** * Visit a node with kind `\ast\AST_FUNC_DECL` * * @param Node $node * A node to parse * * @return Context * A new or an unchanged context resulting from * parsing the node */ public function visitFuncDecl(Decl $node) : Context { $function_name = (string) $node->name; // Hunt for an un-taken alternate ID $alternate_id = 0; $function_fqsen = null; do { $function_fqsen = FullyQualifiedFunctionName::fromStringInContext($function_name, $this->context)->withNamespace($this->context->getNamespace())->withAlternateId($alternate_id++); } while ($this->code_base->hasFunctionWithFQSEN($function_fqsen)); $func = Func::fromNode($this->context->withLineNumberStart($node->lineno ?? 0)->withLineNumberEnd($node->endLineno ?? 0), $this->code_base, $node); $func->setFQSEN($function_fqsen); $this->code_base->addFunction($func); // Send the context into the function and reset the scope $context = $this->context->withMethodFQSEN($function_fqsen)->withScope(new Scope()); // Add each method parameter to the scope. We clone it // so that changes to the variable don't alter the // parameter definition foreach ($func->getParameterList() as $parameter) { $context->addScopeVariable(clone $parameter); } return $context; }
/** * Visit a node with kind `\ast\AST_CLOSURE` * * @param Node $node * A node to parse * * @return Context * A new or an unchanged context resulting from * parsing the node */ public function visitClosure(Decl $node) : Context { $closure_fqsen = FullyQualifiedFunctionName::fromClosureInContext($this->context->withLineNumberStart($node->lineno ?? 0)); $func = Func::fromNode($this->context, $this->code_base, $node, $closure_fqsen); // If we have a 'this' variable in our current scope, // pass it down into the closure if ($this->context->getScope()->hasVariableWithName('this')) { $func->getInternalScope()->addVariable($this->context->getScope()->getVariableByName('this')); } // Make the closure reachable by FQSEN from anywhere $this->code_base->addFunction($func); if (!empty($node->children['uses']) && $node->children['uses']->kind == \ast\AST_CLOSURE_USES) { $uses = $node->children['uses']; foreach ($uses->children as $use) { if ($use->kind != \ast\AST_CLOSURE_VAR) { $this->emitIssue(Issue::VariableUseClause, $node->lineno ?? 0); continue; } $variable_name = (new ContextNode($this->code_base, $this->context, $use->children['name']))->getVariableName(); if (empty($variable_name)) { continue; } $variable = null; // Check to see if the variable exists in this scope if (!$this->context->getScope()->hasVariableWithName($variable_name)) { // If this is not pass-by-reference variable we // have a problem if (!($use->flags & \ast\flags\PARAM_REF)) { $this->emitIssue(Issue::UndeclaredVariable, $node->lineno ?? 0, $variable_name); continue; } else { // If the variable doesn't exist, but its // a pass-by-reference variable, we can // just create it $variable = Variable::fromNodeInContext($use, $this->context, $this->code_base, false); } } else { $variable = $this->context->getScope()->getVariableByName($variable_name); // If this isn't a pass-by-reference variable, we // clone the variable so state within this scope // doesn't update the outer scope if (!($use->flags & \ast\flags\PARAM_REF)) { $variable = clone $variable; } } // Pass the variable into a new scope $func->getInternalScope()->addVariable($variable); } } // Add all parameters to the scope if (!empty($node->children['params']) && $node->children['params']->kind == \ast\AST_PARAM_LIST) { $params = $node->children['params']; foreach ($params->children as $param) { // Read the parameter $parameter = Parameter::fromNode($this->context, $this->code_base, $param); // Add it to the scope $func->getInternalScope()->addVariable($parameter); } } if ($this->analyzeFunctionLikeIsGenerator($node)) { $this->setReturnTypeOfGenerator($func, $node); } return $this->context->withScope($func->getInternalScope()); }