mirror of
https://github.com/danog/psalm.git
synced 2024-12-15 19:07:00 +01:00
1085 lines
44 KiB
PHP
1085 lines
44 KiB
PHP
<?php
|
||
namespace Psalm\Internal\Analyzer\Statements\Expression;
|
||
|
||
use PhpParser;
|
||
use Psalm\CodeLocation;
|
||
use Psalm\Context;
|
||
use Psalm\Internal\Algebra\FormulaGenerator;
|
||
use Psalm\Internal\Analyzer\ClassLikeAnalyzer;
|
||
use Psalm\Internal\Analyzer\FunctionLikeAnalyzer;
|
||
use Psalm\Internal\Analyzer\StatementsAnalyzer;
|
||
use Psalm\Internal\Type\Comparator\UnionTypeComparator;
|
||
use Psalm\Internal\Type\TemplateBound;
|
||
use Psalm\Internal\Type\TemplateResult;
|
||
use Psalm\Internal\Type\TemplateStandinTypeReplacer;
|
||
use Psalm\Issue\ArgumentTypeCoercion;
|
||
use Psalm\Issue\InvalidArgument;
|
||
use Psalm\Issue\InvalidScalarArgument;
|
||
use Psalm\Issue\MixedArgumentTypeCoercion;
|
||
use Psalm\Issue\UndefinedFunction;
|
||
use Psalm\IssueBuffer;
|
||
use Psalm\Node\Expr\BinaryOp\VirtualIdentical;
|
||
use Psalm\Node\Expr\VirtualConstFetch;
|
||
use Psalm\Node\VirtualName;
|
||
use Psalm\Storage\ClassLikeStorage;
|
||
use Psalm\Type;
|
||
use Psalm\Type\Atomic\TNamedObject;
|
||
|
||
use function array_filter;
|
||
use function array_map;
|
||
use function array_merge;
|
||
use function array_unique;
|
||
use function count;
|
||
use function implode;
|
||
use function in_array;
|
||
use function is_int;
|
||
use function preg_match;
|
||
use function preg_replace;
|
||
use function str_replace;
|
||
use function strpos;
|
||
use function strtolower;
|
||
use function substr;
|
||
|
||
/**
|
||
* @internal
|
||
*/
|
||
class CallAnalyzer
|
||
{
|
||
public static function collectSpecialInformation(
|
||
FunctionLikeAnalyzer $source,
|
||
string $method_name,
|
||
Context $context
|
||
): void {
|
||
$fq_class_name = (string)$source->getFQCLN();
|
||
|
||
$project_analyzer = $source->getFileAnalyzer()->project_analyzer;
|
||
$codebase = $source->getCodebase();
|
||
|
||
if ($context->collect_mutations &&
|
||
$context->self &&
|
||
(
|
||
$context->self === $fq_class_name ||
|
||
$codebase->classExtends(
|
||
$context->self,
|
||
$fq_class_name
|
||
)
|
||
)
|
||
) {
|
||
$method_id = new \Psalm\Internal\MethodIdentifier(
|
||
$fq_class_name,
|
||
strtolower($method_name)
|
||
);
|
||
|
||
if ((string) $method_id !== $source->getId()) {
|
||
if ($context->collect_initializations) {
|
||
if (isset($context->initialized_methods[(string) $method_id])) {
|
||
return;
|
||
}
|
||
|
||
if ($context->initialized_methods === null) {
|
||
$context->initialized_methods = [];
|
||
}
|
||
|
||
$context->initialized_methods[(string) $method_id] = true;
|
||
}
|
||
|
||
$project_analyzer->getMethodMutations(
|
||
$method_id,
|
||
$context,
|
||
$source->getRootFilePath(),
|
||
$source->getRootFileName()
|
||
);
|
||
}
|
||
} elseif ($context->collect_initializations &&
|
||
$context->self &&
|
||
(
|
||
$context->self === $fq_class_name
|
||
|| $codebase->classlikes->classExtends(
|
||
$context->self,
|
||
$fq_class_name
|
||
)
|
||
) &&
|
||
$source->getMethodName() !== $method_name
|
||
) {
|
||
$method_id = new \Psalm\Internal\MethodIdentifier($fq_class_name, strtolower($method_name));
|
||
|
||
$declaring_method_id = $codebase->methods->getDeclaringMethodId($method_id);
|
||
|
||
if (isset($context->vars_in_scope['$this'])) {
|
||
foreach ($context->vars_in_scope['$this']->getAtomicTypes() as $atomic_type) {
|
||
if ($atomic_type instanceof TNamedObject) {
|
||
if ($fq_class_name === $atomic_type->value) {
|
||
$alt_declaring_method_id = $declaring_method_id;
|
||
} else {
|
||
$fq_class_name = $atomic_type->value;
|
||
|
||
$method_id = new \Psalm\Internal\MethodIdentifier(
|
||
$fq_class_name,
|
||
strtolower($method_name)
|
||
);
|
||
|
||
$alt_declaring_method_id = $codebase->methods->getDeclaringMethodId($method_id);
|
||
}
|
||
|
||
if ($alt_declaring_method_id) {
|
||
$declaring_method_id = $alt_declaring_method_id;
|
||
break;
|
||
}
|
||
|
||
if (!$atomic_type->extra_types) {
|
||
continue;
|
||
}
|
||
|
||
foreach ($atomic_type->extra_types as $intersection_type) {
|
||
if ($intersection_type instanceof TNamedObject) {
|
||
$fq_class_name = $intersection_type->value;
|
||
$method_id = new \Psalm\Internal\MethodIdentifier(
|
||
$fq_class_name,
|
||
strtolower($method_name)
|
||
);
|
||
|
||
$alt_declaring_method_id = $codebase->methods->getDeclaringMethodId($method_id);
|
||
|
||
if ($alt_declaring_method_id) {
|
||
$declaring_method_id = $alt_declaring_method_id;
|
||
break 2;
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
|
||
if (!$declaring_method_id) {
|
||
// can happen for __call
|
||
return;
|
||
}
|
||
|
||
if (isset($context->initialized_methods[(string) $declaring_method_id])) {
|
||
return;
|
||
}
|
||
|
||
if ($context->initialized_methods === null) {
|
||
$context->initialized_methods = [];
|
||
}
|
||
|
||
$context->initialized_methods[(string) $declaring_method_id] = true;
|
||
|
||
$method_storage = $codebase->methods->getStorage($declaring_method_id);
|
||
|
||
$class_analyzer = $source->getSource();
|
||
|
||
$is_final = $method_storage->final;
|
||
|
||
if ($method_name !== $declaring_method_id->method_name) {
|
||
$appearing_method_id = $codebase->methods->getAppearingMethodId($method_id);
|
||
|
||
if ($appearing_method_id) {
|
||
$appearing_class_storage = $codebase->classlike_storage_provider->get(
|
||
$appearing_method_id->fq_class_name
|
||
);
|
||
|
||
if (isset($appearing_class_storage->trait_final_map[strtolower($method_name)])) {
|
||
$is_final = true;
|
||
}
|
||
}
|
||
}
|
||
|
||
if ($class_analyzer instanceof ClassLikeAnalyzer
|
||
&& !$method_storage->is_static
|
||
&& ($context->collect_nonprivate_initializations
|
||
|| $method_storage->visibility === ClassLikeAnalyzer::VISIBILITY_PRIVATE
|
||
|| $is_final)
|
||
) {
|
||
$local_vars_in_scope = [];
|
||
|
||
foreach ($context->vars_in_scope as $var_id => $type) {
|
||
if (strpos($var_id, '$this->') === 0) {
|
||
if ($type->initialized) {
|
||
$local_vars_in_scope[$var_id] = $context->vars_in_scope[$var_id];
|
||
|
||
unset($context->vars_in_scope[$var_id]);
|
||
unset($context->vars_possibly_in_scope[$var_id]);
|
||
}
|
||
} elseif ($var_id !== '$this') {
|
||
$local_vars_in_scope[$var_id] = $context->vars_in_scope[$var_id];
|
||
}
|
||
}
|
||
|
||
$local_vars_possibly_in_scope = $context->vars_possibly_in_scope;
|
||
|
||
$old_calling_method_id = $context->calling_method_id;
|
||
|
||
if ($fq_class_name === $source->getFQCLN()) {
|
||
$class_analyzer->getMethodMutations($declaring_method_id->method_name, $context);
|
||
} else {
|
||
$declaring_fq_class_name = $declaring_method_id->fq_class_name;
|
||
|
||
$old_self = $context->self;
|
||
$context->self = $declaring_fq_class_name;
|
||
$project_analyzer->getMethodMutations(
|
||
$declaring_method_id,
|
||
$context,
|
||
$source->getRootFilePath(),
|
||
$source->getRootFileName()
|
||
);
|
||
$context->self = $old_self;
|
||
}
|
||
|
||
$context->calling_method_id = $old_calling_method_id;
|
||
|
||
foreach ($local_vars_in_scope as $var => $type) {
|
||
$context->vars_in_scope[$var] = $type;
|
||
}
|
||
|
||
foreach ($local_vars_possibly_in_scope as $var => $_) {
|
||
$context->vars_possibly_in_scope[$var] = true;
|
||
}
|
||
}
|
||
}
|
||
}
|
||
|
||
/**
|
||
* @param list<PhpParser\Node\Arg> $args
|
||
*/
|
||
public static function checkMethodArgs(
|
||
?\Psalm\Internal\MethodIdentifier $method_id,
|
||
array $args,
|
||
?TemplateResult $class_template_result,
|
||
Context $context,
|
||
CodeLocation $code_location,
|
||
StatementsAnalyzer $statements_analyzer
|
||
) : bool {
|
||
$codebase = $statements_analyzer->getCodebase();
|
||
|
||
if (!$method_id) {
|
||
return Call\ArgumentsAnalyzer::analyze(
|
||
$statements_analyzer,
|
||
$args,
|
||
null,
|
||
null,
|
||
true,
|
||
$context,
|
||
$class_template_result
|
||
) !== false;
|
||
}
|
||
|
||
$method_params = $codebase->methods->getMethodParams($method_id, $statements_analyzer, $args, $context);
|
||
|
||
$fq_class_name = $method_id->fq_class_name;
|
||
$method_name = $method_id->method_name;
|
||
|
||
$fq_class_name = strtolower($codebase->classlikes->getUnAliasedName($fq_class_name));
|
||
|
||
$class_storage = $codebase->classlike_storage_provider->get($fq_class_name);
|
||
|
||
$method_storage = null;
|
||
|
||
if (isset($class_storage->declaring_method_ids[$method_name])) {
|
||
$declaring_method_id = $class_storage->declaring_method_ids[$method_name];
|
||
|
||
$declaring_fq_class_name = $declaring_method_id->fq_class_name;
|
||
$declaring_method_name = $declaring_method_id->method_name;
|
||
|
||
if ($declaring_fq_class_name !== $fq_class_name) {
|
||
$declaring_class_storage = $codebase->classlike_storage_provider->get($declaring_fq_class_name);
|
||
} else {
|
||
$declaring_class_storage = $class_storage;
|
||
}
|
||
|
||
if (!isset($declaring_class_storage->methods[$declaring_method_name])) {
|
||
throw new \UnexpectedValueException('Storage should not be empty here');
|
||
}
|
||
|
||
$method_storage = $declaring_class_storage->methods[$declaring_method_name];
|
||
|
||
if ($declaring_class_storage->user_defined
|
||
&& !$method_storage->has_docblock_param_types
|
||
&& isset($declaring_class_storage->documenting_method_ids[$method_name])
|
||
) {
|
||
$documenting_method_id = $declaring_class_storage->documenting_method_ids[$method_name];
|
||
|
||
$documenting_method_storage = $codebase->methods->getStorage($documenting_method_id);
|
||
|
||
if ($documenting_method_storage->template_types) {
|
||
$method_storage = $documenting_method_storage;
|
||
}
|
||
}
|
||
|
||
if (!$context->isSuppressingExceptions($statements_analyzer)) {
|
||
$context->mergeFunctionExceptions($method_storage, $code_location);
|
||
}
|
||
}
|
||
|
||
if (Call\ArgumentsAnalyzer::analyze(
|
||
$statements_analyzer,
|
||
$args,
|
||
$method_params,
|
||
(string) $method_id,
|
||
$method_storage->allow_named_arg_calls ?? true,
|
||
$context,
|
||
$class_template_result
|
||
) === false) {
|
||
return false;
|
||
}
|
||
|
||
if (Call\ArgumentsAnalyzer::checkArgumentsMatch(
|
||
$statements_analyzer,
|
||
$args,
|
||
$method_id,
|
||
$method_params,
|
||
$method_storage,
|
||
$class_storage,
|
||
$class_template_result,
|
||
$code_location,
|
||
$context
|
||
) === false) {
|
||
return false;
|
||
}
|
||
|
||
if ($class_template_result) {
|
||
self::checkTemplateResult(
|
||
$statements_analyzer,
|
||
$class_template_result,
|
||
$code_location,
|
||
strtolower((string) $method_id)
|
||
);
|
||
}
|
||
|
||
return true;
|
||
}
|
||
|
||
/**
|
||
* This gets all the template params (and their types) that we think
|
||
* we'll need to know about
|
||
*
|
||
* @return array<string, array<string, Type\Union>>
|
||
* @param array<string, non-empty-array<string, Type\Union>> $existing_template_types
|
||
* @param array<string, array<string, Type\Union>> $class_template_params
|
||
*/
|
||
public static function getTemplateTypesForCall(
|
||
\Psalm\Codebase $codebase,
|
||
?ClassLikeStorage $declaring_class_storage,
|
||
?string $appearing_class_name,
|
||
?ClassLikeStorage $calling_class_storage,
|
||
array $existing_template_types = [],
|
||
array $class_template_params = []
|
||
) : array {
|
||
$template_types = $existing_template_types;
|
||
|
||
if ($declaring_class_storage) {
|
||
if ($calling_class_storage
|
||
&& $declaring_class_storage !== $calling_class_storage
|
||
&& $calling_class_storage->template_extended_params
|
||
) {
|
||
foreach ($calling_class_storage->template_extended_params as $class_name => $type_map) {
|
||
foreach ($type_map as $template_name => $type) {
|
||
if ($class_name === $declaring_class_storage->name) {
|
||
$output_type = null;
|
||
|
||
foreach ($type->getAtomicTypes() as $atomic_type) {
|
||
if ($atomic_type instanceof Type\Atomic\TTemplateParam) {
|
||
$output_type_candidate = self::getGenericParamForOffset(
|
||
$atomic_type->defining_class,
|
||
$atomic_type->param_name,
|
||
$calling_class_storage->template_extended_params,
|
||
$class_template_params + $template_types
|
||
);
|
||
} else {
|
||
$output_type_candidate = new Type\Union([$atomic_type]);
|
||
}
|
||
|
||
$output_type = Type::combineUnionTypes(
|
||
$output_type_candidate,
|
||
$output_type
|
||
);
|
||
}
|
||
|
||
$template_types[$template_name][$declaring_class_storage->name] = $output_type;
|
||
}
|
||
}
|
||
}
|
||
} elseif ($declaring_class_storage->template_types) {
|
||
foreach ($declaring_class_storage->template_types as $template_name => $type_map) {
|
||
foreach ($type_map as $key => $type) {
|
||
$template_types[$template_name][$key]
|
||
= $class_template_params[$template_name][$key] ?? $type;
|
||
}
|
||
}
|
||
}
|
||
}
|
||
|
||
foreach ($template_types as $key => $type_map) {
|
||
foreach ($type_map as $class => $type) {
|
||
$template_types[$key][$class] = \Psalm\Internal\Type\TypeExpander::expandUnion(
|
||
$codebase,
|
||
$type,
|
||
$appearing_class_name,
|
||
$calling_class_storage->name ?? null,
|
||
null,
|
||
true,
|
||
false,
|
||
$calling_class_storage->final ?? false
|
||
);
|
||
}
|
||
}
|
||
|
||
return $template_types;
|
||
}
|
||
|
||
/**
|
||
* @param array<string, array<string, Type\Union>> $template_extended_params
|
||
* @param array<string, array<string, Type\Union>> $found_generic_params
|
||
*/
|
||
public static function getGenericParamForOffset(
|
||
string $fq_class_name,
|
||
string $template_name,
|
||
array $template_extended_params,
|
||
array $found_generic_params
|
||
): Type\Union {
|
||
if (isset($found_generic_params[$template_name][$fq_class_name])) {
|
||
return $found_generic_params[$template_name][$fq_class_name];
|
||
}
|
||
|
||
foreach ($template_extended_params as $extended_class_name => $type_map) {
|
||
foreach ($type_map as $extended_template_name => $extended_type) {
|
||
foreach ($extended_type->getAtomicTypes() as $extended_atomic_type) {
|
||
if ($extended_atomic_type instanceof Type\Atomic\TTemplateParam
|
||
&& $extended_atomic_type->param_name === $template_name
|
||
&& $extended_atomic_type->defining_class === $fq_class_name
|
||
) {
|
||
return self::getGenericParamForOffset(
|
||
$extended_class_name,
|
||
$extended_template_name,
|
||
$template_extended_params,
|
||
$found_generic_params
|
||
);
|
||
}
|
||
}
|
||
}
|
||
}
|
||
|
||
return Type::getMixed();
|
||
}
|
||
|
||
/**
|
||
* @param PhpParser\Node\Scalar\String_|PhpParser\Node\Expr\Array_|PhpParser\Node\Expr\BinaryOp\Concat $callable_arg
|
||
*
|
||
* @return list<non-empty-string>
|
||
*
|
||
* @psalm-suppress LessSpecificReturnStatement
|
||
* @psalm-suppress MoreSpecificReturnType
|
||
*/
|
||
public static function getFunctionIdsFromCallableArg(
|
||
\Psalm\FileSource $file_source,
|
||
PhpParser\Node\Expr $callable_arg
|
||
): array {
|
||
if ($callable_arg instanceof PhpParser\Node\Expr\BinaryOp\Concat) {
|
||
if ($callable_arg->left instanceof PhpParser\Node\Expr\ClassConstFetch
|
||
&& $callable_arg->left->class instanceof PhpParser\Node\Name
|
||
&& $callable_arg->left->name instanceof PhpParser\Node\Identifier
|
||
&& strtolower($callable_arg->left->name->name) === 'class'
|
||
&& !in_array(strtolower($callable_arg->left->class->parts[0]), ['self', 'static', 'parent'])
|
||
&& $callable_arg->right instanceof PhpParser\Node\Scalar\String_
|
||
&& preg_match('/^::[A-Za-z0-9]+$/', $callable_arg->right->value)
|
||
) {
|
||
return [
|
||
(string) $callable_arg->left->class->getAttribute('resolvedName') . $callable_arg->right->value
|
||
];
|
||
}
|
||
|
||
return [];
|
||
}
|
||
|
||
if ($callable_arg instanceof PhpParser\Node\Scalar\String_) {
|
||
$potential_id = preg_replace('/^\\\/', '', $callable_arg->value);
|
||
|
||
if (preg_match('/^[A-Za-z0-9_]+(\\\[A-Za-z0-9_]+)*(::[A-Za-z0-9_]+)?$/', $potential_id)) {
|
||
return [$potential_id];
|
||
}
|
||
|
||
return [];
|
||
}
|
||
|
||
if (count($callable_arg->items) !== 2) {
|
||
return [];
|
||
}
|
||
|
||
/** @psalm-suppress PossiblyNullPropertyFetch */
|
||
if ($callable_arg->items[0]->key || $callable_arg->items[1]->key) {
|
||
return [];
|
||
}
|
||
|
||
if (!isset($callable_arg->items[0]) || !isset($callable_arg->items[1])) {
|
||
throw new \UnexpectedValueException('These should never be unset');
|
||
}
|
||
|
||
$class_arg = $callable_arg->items[0]->value;
|
||
$method_name_arg = $callable_arg->items[1]->value;
|
||
|
||
if (!$method_name_arg instanceof PhpParser\Node\Scalar\String_) {
|
||
return [];
|
||
}
|
||
|
||
if ($class_arg instanceof PhpParser\Node\Scalar\String_) {
|
||
return [preg_replace('/^\\\/', '', $class_arg->value) . '::' . $method_name_arg->value];
|
||
}
|
||
|
||
if ($class_arg instanceof PhpParser\Node\Expr\ClassConstFetch
|
||
&& $class_arg->name instanceof PhpParser\Node\Identifier
|
||
&& strtolower($class_arg->name->name) === 'class'
|
||
&& $class_arg->class instanceof PhpParser\Node\Name
|
||
) {
|
||
$fq_class_name = ClassLikeAnalyzer::getFQCLNFromNameObject(
|
||
$class_arg->class,
|
||
$file_source->getAliases()
|
||
);
|
||
|
||
return [$fq_class_name . '::' . $method_name_arg->value];
|
||
}
|
||
|
||
if (!$file_source instanceof StatementsAnalyzer
|
||
|| !($class_arg_type = $file_source->node_data->getType($class_arg))
|
||
) {
|
||
return [];
|
||
}
|
||
|
||
$method_ids = [];
|
||
|
||
foreach ($class_arg_type->getAtomicTypes() as $type_part) {
|
||
if ($type_part instanceof TNamedObject) {
|
||
$method_id = $type_part->value . '::' . $method_name_arg->value;
|
||
|
||
if ($type_part->extra_types) {
|
||
foreach ($type_part->extra_types as $extra_type) {
|
||
if ($extra_type instanceof Type\Atomic\TTemplateParam
|
||
|| $extra_type instanceof Type\Atomic\TObjectWithProperties
|
||
) {
|
||
throw new \UnexpectedValueException('Shouldn’t get a generic param here');
|
||
}
|
||
|
||
$method_id .= '&' . $extra_type->value . '::' . $method_name_arg->value;
|
||
}
|
||
}
|
||
|
||
$method_ids[] = '$' . $method_id;
|
||
}
|
||
}
|
||
|
||
return $method_ids;
|
||
}
|
||
|
||
/**
|
||
* @param non-empty-string $function_id
|
||
* @param bool $can_be_in_root_scope if true, the function can be shortened to the root version
|
||
*
|
||
*/
|
||
public static function checkFunctionExists(
|
||
StatementsAnalyzer $statements_analyzer,
|
||
string &$function_id,
|
||
CodeLocation $code_location,
|
||
bool $can_be_in_root_scope
|
||
): bool {
|
||
$cased_function_id = $function_id;
|
||
$function_id = strtolower($function_id);
|
||
|
||
$codebase = $statements_analyzer->getCodebase();
|
||
|
||
if (!$codebase->functions->functionExists($statements_analyzer, $function_id)) {
|
||
/** @var non-empty-lowercase-string */
|
||
$root_function_id = preg_replace('/.*\\\/', '', $function_id);
|
||
|
||
if ($can_be_in_root_scope
|
||
&& $function_id !== $root_function_id
|
||
&& $codebase->functions->functionExists($statements_analyzer, $root_function_id)
|
||
) {
|
||
$function_id = $root_function_id;
|
||
} else {
|
||
if (IssueBuffer::accepts(
|
||
new UndefinedFunction(
|
||
'Function ' . $cased_function_id . ' does not exist',
|
||
$code_location,
|
||
$function_id
|
||
),
|
||
$statements_analyzer->getSuppressedIssues()
|
||
)) {
|
||
// fall through
|
||
}
|
||
|
||
return false;
|
||
}
|
||
}
|
||
|
||
return true;
|
||
}
|
||
|
||
/**
|
||
* @param PhpParser\Node\Identifier|PhpParser\Node\Name $expr
|
||
* @param \Psalm\Storage\Assertion[] $assertions
|
||
* @param string $thisName
|
||
* @param list<PhpParser\Node\Arg> $args
|
||
* @param array<string, array<string, non-empty-list<TemplateBound>>> $inferred_lower_bounds,
|
||
*
|
||
*/
|
||
public static function applyAssertionsToContext(
|
||
PhpParser\NodeAbstract $expr,
|
||
?string $thisName,
|
||
array $assertions,
|
||
array $args,
|
||
array $inferred_lower_bounds,
|
||
Context $context,
|
||
StatementsAnalyzer $statements_analyzer
|
||
): void {
|
||
$type_assertions = [];
|
||
|
||
$asserted_keys = [];
|
||
|
||
foreach ($assertions as $assertion) {
|
||
$assertion_var_id = null;
|
||
|
||
$arg_value = null;
|
||
|
||
if (is_int($assertion->var_id)) {
|
||
if (!isset($args[$assertion->var_id])) {
|
||
continue;
|
||
}
|
||
|
||
$arg_value = $args[$assertion->var_id]->value;
|
||
|
||
$arg_var_id = ExpressionIdentifier::getArrayVarId($arg_value, null, $statements_analyzer);
|
||
|
||
if ($arg_var_id) {
|
||
$assertion_var_id = $arg_var_id;
|
||
}
|
||
} elseif ($assertion->var_id === '$this' && $thisName !== null) {
|
||
$assertion_var_id = $thisName;
|
||
} elseif (strpos($assertion->var_id, '$this->') === 0 && $thisName !== null) {
|
||
$assertion_var_id = $thisName . str_replace('$this->', '->', $assertion->var_id);
|
||
} elseif (strpos($assertion->var_id, 'self::') === 0 && $context->self) {
|
||
$assertion_var_id = $context->self . str_replace('self::', '::', $assertion->var_id);
|
||
} elseif (strpos($assertion->var_id, '::$') !== false) {
|
||
// allow assertions to bring external static props into scope
|
||
$assertion_var_id = $assertion->var_id;
|
||
} elseif (isset($context->vars_in_scope[$assertion->var_id])) {
|
||
$assertion_var_id = $assertion->var_id;
|
||
}
|
||
|
||
$codebase = $statements_analyzer->getCodebase();
|
||
|
||
if ($assertion_var_id) {
|
||
$rule = $assertion->rule[0][0];
|
||
|
||
$prefix = '';
|
||
if ($rule[0] === '!') {
|
||
$prefix .= '!';
|
||
$rule = substr($rule, 1);
|
||
}
|
||
if ($rule[0] === '=') {
|
||
$prefix .= '=';
|
||
$rule = substr($rule, 1);
|
||
}
|
||
if ($rule[0] === '~') {
|
||
$prefix .= '~';
|
||
$rule = substr($rule, 1);
|
||
}
|
||
|
||
if (isset($inferred_lower_bounds[$rule])) {
|
||
foreach ($inferred_lower_bounds[$rule] as $lower_bounds) {
|
||
$lower_bound_type = TemplateStandinTypeReplacer::getMostSpecificTypeFromBounds(
|
||
$lower_bounds,
|
||
$codebase
|
||
);
|
||
|
||
if ($lower_bound_type->hasMixed()) {
|
||
continue 2;
|
||
}
|
||
|
||
$replacement_atomic_types = $lower_bound_type->getAtomicTypes();
|
||
|
||
if (count($replacement_atomic_types) > 1) {
|
||
continue 2;
|
||
}
|
||
|
||
$ored_type_assertions = [];
|
||
|
||
foreach ($replacement_atomic_types as $replacement_atomic_type) {
|
||
if ($replacement_atomic_type instanceof Type\Atomic\TMixed) {
|
||
continue 3;
|
||
}
|
||
|
||
if ($replacement_atomic_type instanceof Type\Atomic\TArray
|
||
|| $replacement_atomic_type instanceof Type\Atomic\TKeyedArray
|
||
) {
|
||
$ored_type_assertions[] = $prefix . 'array';
|
||
} elseif ($replacement_atomic_type instanceof Type\Atomic\TNamedObject) {
|
||
$ored_type_assertions[] = $prefix . $replacement_atomic_type->value;
|
||
} elseif ($replacement_atomic_type instanceof Type\Atomic\Scalar) {
|
||
$ored_type_assertions[] = $prefix . $replacement_atomic_type->getAssertionString();
|
||
} elseif ($replacement_atomic_type instanceof Type\Atomic\TNull) {
|
||
$ored_type_assertions[] = $prefix . 'null';
|
||
} elseif ($replacement_atomic_type instanceof Type\Atomic\TTemplateParam) {
|
||
$ored_type_assertions[] = $prefix . $replacement_atomic_type->param_name;
|
||
}
|
||
}
|
||
|
||
if ($ored_type_assertions) {
|
||
$type_assertions[$assertion_var_id] = [$ored_type_assertions];
|
||
}
|
||
}
|
||
} else {
|
||
if (isset($type_assertions[$assertion_var_id])) {
|
||
$type_assertions[$assertion_var_id] = array_merge(
|
||
$type_assertions[$assertion_var_id],
|
||
$assertion->rule
|
||
);
|
||
} else {
|
||
$type_assertions[$assertion_var_id] = $assertion->rule;
|
||
}
|
||
}
|
||
} elseif ($arg_value && ($assertion->rule === [['!falsy']] || $assertion->rule === [['true']])) {
|
||
if ($assertion->rule === [['true']]) {
|
||
$conditional = new VirtualIdentical(
|
||
$arg_value,
|
||
new VirtualConstFetch(new VirtualName('true'))
|
||
);
|
||
|
||
$assert_clauses = FormulaGenerator::getFormula(
|
||
\mt_rand(0, 1000000),
|
||
\mt_rand(0, 1000000),
|
||
$conditional,
|
||
$context->self,
|
||
$statements_analyzer,
|
||
$codebase
|
||
);
|
||
} else {
|
||
$assert_clauses = FormulaGenerator::getFormula(
|
||
\spl_object_id($arg_value),
|
||
\spl_object_id($arg_value),
|
||
$arg_value,
|
||
$context->self,
|
||
$statements_analyzer,
|
||
$statements_analyzer->getCodebase()
|
||
);
|
||
}
|
||
|
||
$simplified_clauses = \Psalm\Internal\Algebra::simplifyCNF(
|
||
array_merge($context->clauses, $assert_clauses)
|
||
);
|
||
|
||
$assert_type_assertions = \Psalm\Internal\Algebra::getTruthsFromFormula(
|
||
$simplified_clauses
|
||
);
|
||
|
||
$type_assertions = array_merge($type_assertions, $assert_type_assertions);
|
||
} elseif ($arg_value && $assertion->rule === [['falsy']]) {
|
||
$assert_clauses = \Psalm\Internal\Algebra::negateFormula(
|
||
FormulaGenerator::getFormula(
|
||
\spl_object_id($arg_value),
|
||
\spl_object_id($arg_value),
|
||
$arg_value,
|
||
$context->self,
|
||
$statements_analyzer,
|
||
$codebase
|
||
)
|
||
);
|
||
|
||
$simplified_clauses = \Psalm\Internal\Algebra::simplifyCNF(
|
||
array_merge($context->clauses, $assert_clauses)
|
||
);
|
||
|
||
$assert_type_assertions = \Psalm\Internal\Algebra::getTruthsFromFormula(
|
||
$simplified_clauses
|
||
);
|
||
|
||
$type_assertions = array_merge($type_assertions, $assert_type_assertions);
|
||
}
|
||
}
|
||
|
||
$changed_var_ids = [];
|
||
|
||
foreach ($type_assertions as $var_id => $_) {
|
||
$asserted_keys[$var_id] = true;
|
||
}
|
||
|
||
$codebase = $statements_analyzer->getCodebase();
|
||
|
||
if ($type_assertions) {
|
||
$template_type_map = array_map(
|
||
function ($type_map) use ($codebase) {
|
||
return array_map(
|
||
function ($bounds) use ($codebase) {
|
||
return TemplateStandinTypeReplacer::getMostSpecificTypeFromBounds(
|
||
$bounds,
|
||
$codebase
|
||
);
|
||
},
|
||
$type_map
|
||
);
|
||
},
|
||
$inferred_lower_bounds
|
||
);
|
||
|
||
foreach (($statements_analyzer->getTemplateTypeMap() ?: []) as $template_name => $map) {
|
||
foreach ($map as $ref => $type) {
|
||
$template_type_map[$template_name][$ref] = new Type\Union([
|
||
new Type\Atomic\TTemplateParam(
|
||
$template_name,
|
||
$type,
|
||
$ref
|
||
)
|
||
]);
|
||
}
|
||
}
|
||
|
||
// while in an and, we allow scope to boil over to support
|
||
// statements of the form if ($x && $x->foo())
|
||
$op_vars_in_scope = \Psalm\Type\Reconciler::reconcileKeyedTypes(
|
||
$type_assertions,
|
||
$type_assertions,
|
||
$context->vars_in_scope,
|
||
$changed_var_ids,
|
||
$asserted_keys,
|
||
$statements_analyzer,
|
||
$template_type_map,
|
||
$context->inside_loop,
|
||
new CodeLocation($statements_analyzer->getSource(), $expr)
|
||
);
|
||
|
||
foreach ($changed_var_ids as $var_id => $_) {
|
||
if (isset($op_vars_in_scope[$var_id])) {
|
||
$first_appearance = $statements_analyzer->getFirstAppearance($var_id);
|
||
|
||
if ($first_appearance
|
||
&& isset($context->vars_in_scope[$var_id])
|
||
&& $context->vars_in_scope[$var_id]->hasMixed()
|
||
) {
|
||
if (!$context->collect_initializations
|
||
&& !$context->collect_mutations
|
||
&& $statements_analyzer->getFilePath() === $statements_analyzer->getRootFilePath()
|
||
&& (!(($parent_source = $statements_analyzer->getSource())
|
||
instanceof \Psalm\Internal\Analyzer\FunctionLikeAnalyzer)
|
||
|| !$parent_source->getSource() instanceof \Psalm\Internal\Analyzer\TraitAnalyzer)
|
||
) {
|
||
$codebase->analyzer->decrementMixedCount($statements_analyzer->getFilePath());
|
||
}
|
||
|
||
IssueBuffer::remove(
|
||
$statements_analyzer->getFilePath(),
|
||
'MixedAssignment',
|
||
$first_appearance->raw_file_start
|
||
);
|
||
}
|
||
|
||
if ($template_type_map) {
|
||
$readonly_template_result = new TemplateResult($template_type_map, $template_type_map);
|
||
|
||
\Psalm\Internal\Type\TemplateInferredTypeReplacer::replace(
|
||
$op_vars_in_scope[$var_id],
|
||
$readonly_template_result,
|
||
$codebase
|
||
);
|
||
}
|
||
|
||
$op_vars_in_scope[$var_id]->from_docblock = true;
|
||
|
||
foreach ($op_vars_in_scope[$var_id]->getAtomicTypes() as $changed_atomic_type) {
|
||
$changed_atomic_type->from_docblock = true;
|
||
|
||
if ($changed_atomic_type instanceof Type\Atomic\TNamedObject
|
||
&& $changed_atomic_type->extra_types
|
||
) {
|
||
foreach ($changed_atomic_type->extra_types as $extra_type) {
|
||
$extra_type->from_docblock = true;
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
|
||
$context->vars_in_scope = $op_vars_in_scope;
|
||
}
|
||
}
|
||
|
||
/**
|
||
* This method looks for problems with a generated TemplateResult.
|
||
*
|
||
* The TemplateResult object contains upper bounds and lower bounds for each template param.
|
||
*
|
||
* Those upper bounds represent a series of constraints like
|
||
*
|
||
* Lower bound:
|
||
* T >: X (the type param T matches X, or is a supertype of X)
|
||
* Upper bound:
|
||
* T <: Y (the type param T matches Y, or is a subtype of Y)
|
||
* Equality (currently represented as an upper bound with a special flag)
|
||
* T = Z (the template T must match Z)
|
||
*
|
||
* This method attempts to reconcile those constraints.
|
||
*
|
||
* Valid constraints:
|
||
*
|
||
* T <: int|float, T >: int --- implies T is an int
|
||
* T = int --- implies T is an int
|
||
*
|
||
* Invalid constraints:
|
||
*
|
||
* T <: int|string, T >: string|float --- implies T <: int and T >: float, which is impossible
|
||
* T = int, T = string --- implies T is a string _and_ and int, which is impossible
|
||
*/
|
||
public static function checkTemplateResult(
|
||
StatementsAnalyzer $statements_analyzer,
|
||
TemplateResult $template_result,
|
||
CodeLocation $code_location,
|
||
?string $function_id
|
||
) : void {
|
||
if ($template_result->lower_bounds && $template_result->upper_bounds) {
|
||
foreach ($template_result->upper_bounds as $template_name => $defining_map) {
|
||
foreach ($defining_map as $defining_id => $upper_bound) {
|
||
if (isset($template_result->lower_bounds[$template_name][$defining_id])) {
|
||
$lower_bound_type = TemplateStandinTypeReplacer::getMostSpecificTypeFromBounds(
|
||
$template_result->lower_bounds[$template_name][$defining_id],
|
||
$statements_analyzer->getCodebase()
|
||
);
|
||
|
||
$upper_bound_type = $upper_bound->type;
|
||
|
||
$union_comparison_result = new \Psalm\Internal\Type\Comparator\TypeComparisonResult();
|
||
|
||
if (count($template_result->upper_bounds_unintersectable_types) > 1) {
|
||
[$lower_bound_type, $upper_bound_type]
|
||
= $template_result->upper_bounds_unintersectable_types;
|
||
}
|
||
|
||
if (!UnionTypeComparator::isContainedBy(
|
||
$statements_analyzer->getCodebase(),
|
||
$lower_bound_type,
|
||
$upper_bound_type,
|
||
false,
|
||
false,
|
||
$union_comparison_result
|
||
)) {
|
||
if ($union_comparison_result->type_coerced) {
|
||
if ($union_comparison_result->type_coerced_from_mixed) {
|
||
if (IssueBuffer::accepts(
|
||
new MixedArgumentTypeCoercion(
|
||
'Type ' . $lower_bound_type->getId() . ' should be a subtype of '
|
||
. $upper_bound_type->getId(),
|
||
$code_location,
|
||
$function_id
|
||
),
|
||
$statements_analyzer->getSuppressedIssues()
|
||
)) {
|
||
// continue
|
||
}
|
||
} else {
|
||
if (IssueBuffer::accepts(
|
||
new ArgumentTypeCoercion(
|
||
'Type ' . $lower_bound_type->getId() . ' should be a subtype of '
|
||
. $upper_bound_type->getId(),
|
||
$code_location,
|
||
$function_id
|
||
),
|
||
$statements_analyzer->getSuppressedIssues()
|
||
)) {
|
||
// continue
|
||
}
|
||
}
|
||
} elseif ($union_comparison_result->scalar_type_match_found) {
|
||
if (IssueBuffer::accepts(
|
||
new InvalidScalarArgument(
|
||
'Type ' . $lower_bound_type->getId() . ' should be a subtype of '
|
||
. $upper_bound_type->getId(),
|
||
$code_location,
|
||
$function_id
|
||
),
|
||
$statements_analyzer->getSuppressedIssues()
|
||
)) {
|
||
// continue
|
||
}
|
||
} else {
|
||
if (IssueBuffer::accepts(
|
||
new InvalidArgument(
|
||
'Type ' . $lower_bound_type->getId() . ' should be a subtype of '
|
||
. $upper_bound_type->getId(),
|
||
$code_location,
|
||
$function_id
|
||
),
|
||
$statements_analyzer->getSuppressedIssues()
|
||
)) {
|
||
// continue
|
||
}
|
||
}
|
||
}
|
||
} else {
|
||
$template_result->lower_bounds[$template_name][$defining_id] = [
|
||
new TemplateBound(
|
||
clone $upper_bound->type
|
||
)
|
||
];
|
||
}
|
||
}
|
||
}
|
||
}
|
||
|
||
// Attempt to identify invalid lower bounds
|
||
foreach ($template_result->lower_bounds as $template_name => $lower_bounds) {
|
||
foreach ($lower_bounds as $lower_bounds) {
|
||
if (count($lower_bounds) > 1) {
|
||
$bounds_with_equality = array_filter(
|
||
$lower_bounds,
|
||
function ($lower_bound) {
|
||
return (bool)$lower_bound->equality_bound_classlike;
|
||
}
|
||
);
|
||
|
||
if (!$bounds_with_equality) {
|
||
continue;
|
||
}
|
||
|
||
$equality_types = array_unique(
|
||
array_map(
|
||
function ($bound_with_equality) {
|
||
return $bound_with_equality->type->getId();
|
||
},
|
||
$bounds_with_equality
|
||
)
|
||
);
|
||
|
||
if (count($equality_types) > 1) {
|
||
if (IssueBuffer::accepts(
|
||
new InvalidArgument(
|
||
'Incompatible types found for ' . $template_name . ' (must have only one of ' .
|
||
implode(', ', $equality_types) . ')',
|
||
$code_location,
|
||
$function_id
|
||
),
|
||
$statements_analyzer->getSuppressedIssues()
|
||
)) {
|
||
// continue
|
||
}
|
||
} else {
|
||
foreach ($lower_bounds as $lower_bound) {
|
||
if ($lower_bound->equality_bound_classlike === null) {
|
||
if (!in_array($lower_bound->type->getId(), $equality_types, true)) {
|
||
if (IssueBuffer::accepts(
|
||
new InvalidArgument(
|
||
'Incompatible types found for ' . $template_name . ' (' .
|
||
$lower_bound->type->getId() . ' is not in ' .
|
||
implode(', ', $equality_types) . ')',
|
||
$code_location,
|
||
$function_id
|
||
),
|
||
$statements_analyzer->getSuppressedIssues()
|
||
)) {
|
||
// continue
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|