1
0
mirror of https://github.com/danog/psalm.git synced 2024-12-14 02:07:37 +01:00
psalm/src/Psalm/Checker/MethodChecker.php
2017-11-10 18:08:26 -05:00

784 lines
26 KiB
PHP

<?php
namespace Psalm\Checker;
use PhpParser;
use Psalm\CodeLocation;
use Psalm\Issue\DeprecatedMethod;
use Psalm\Issue\InaccessibleMethod;
use Psalm\Issue\InvalidStaticInvocation;
use Psalm\Issue\NonStaticSelfCall;
use Psalm\Issue\UndefinedMethod;
use Psalm\IssueBuffer;
use Psalm\StatementsSource;
use Psalm\Storage\MethodStorage;
use Psalm\Type;
class MethodChecker extends FunctionLikeChecker
{
/**
* @param PhpParser\Node\FunctionLike $function
* @param StatementsSource $source
* @psalm-suppress MixedAssignment
*/
public function __construct($function, StatementsSource $source)
{
if (!$function instanceof PhpParser\Node\Stmt\ClassMethod) {
throw new \InvalidArgumentException('Must be called with a ClassMethod');
}
parent::__construct($function, $source);
}
/**
* @param string $method_id
*
* @return array<int, \Psalm\FunctionLikeParameter>
*/
public static function getMethodParams(ProjectChecker $project_checker, $method_id)
{
if ($method_id = self::getDeclaringMethodId($project_checker, $method_id)) {
$storage = self::getStorage($project_checker, $method_id);
if ($storage) {
return $storage->params;
}
}
throw new \UnexpectedValueException('Cannot get method params for ' . $method_id);
}
/**
* @param string $method_id
*
* @return bool
*/
public static function isVariadic(ProjectChecker $project_checker, $method_id)
{
$method_id = (string)self::getDeclaringMethodId($project_checker, $method_id);
list($fq_class_name, $method_name) = explode('::', $method_id);
return $project_checker->classlike_storage_provider->get($fq_class_name)->methods[$method_name]->variadic;
}
/**
* @param string $method_id
*
* @return Type\Union|null
*/
public static function getMethodReturnType(ProjectChecker $project_checker, $method_id)
{
$method_id = self::getDeclaringMethodId($project_checker, $method_id);
if (!$method_id) {
return null;
}
list($fq_class_name, $method_name) = explode('::', $method_id);
if (!ClassLikeChecker::isUserDefined($project_checker, $fq_class_name)
&& FunctionChecker::inCallMap($method_id)
) {
return FunctionChecker::getReturnTypeFromCallMap($method_id);
}
$storage = self::getStorage($project_checker, $method_id);
if (!$storage) {
throw new \UnexpectedValueException('$storage should not be null for ' . $method_id);
}
if ($storage->return_type) {
return $storage->return_type;
}
$class_storage = $project_checker->classlike_storage_provider->get($fq_class_name);
foreach ($class_storage->overridden_method_ids[$method_name] as $overridden_method_id) {
$overridden_storage = self::getStorage($project_checker, $overridden_method_id);
if ($overridden_storage && $overridden_storage->return_type) {
if ($overridden_storage->return_type->isNull()) {
return Type::getVoid();
}
return $overridden_storage->return_type;
}
}
return null;
}
/**
* @param string $method_id
* @param CodeLocation|null $defined_location
*
* @return CodeLocation|null
*/
public static function getMethodReturnTypeLocation(
ProjectChecker $project_checker,
$method_id,
CodeLocation &$defined_location = null
) {
$method_id = self::getDeclaringMethodId($project_checker, $method_id);
if ($method_id === null) {
return null;
}
$storage = self::getStorage($project_checker, $method_id);
if (!$storage) {
throw new \UnexpectedValueException('$storage should not be null for ' . $method_id);
}
if (!$storage->return_type_location) {
$overridden_method_ids = self::getOverriddenMethodIds($project_checker, $method_id);
foreach ($overridden_method_ids as $overridden_method_id) {
$overridden_storage = self::getStorage($project_checker, $overridden_method_id);
if ($overridden_storage && $overridden_storage->return_type_location) {
$defined_location = $overridden_storage->return_type_location;
break;
}
}
}
return $storage->return_type_location;
}
/**
* @param \ReflectionMethod $method
* @param ProjectChecker $project_checker
*
* @return null
*/
public static function extractReflectionMethodInfo(\ReflectionMethod $method, ProjectChecker $project_checker)
{
$method_name = strtolower($method->getName());
$class_storage = $project_checker->classlike_storage_provider->get($method->class);
if (isset($class_storage->methods[strtolower($method_name)])) {
return;
}
$method_id = $method->class . '::' . $method_name;
$storage = $class_storage->methods[strtolower($method_name)] = new MethodStorage();
$storage->cased_name = $method->name;
if (strtolower((string)$method->name) === strtolower((string)$method->class)) {
self::setDeclaringMethodId(
$project_checker,
$method->class . '::__construct',
$method->class . '::' . $method_name
);
self::setAppearingMethodId(
$project_checker,
$method->class . '::__construct',
$method->class . '::' . $method_name
);
}
/** @var \ReflectionClass */
$declaring_class = $method->getDeclaringClass();
$storage->is_static = $method->isStatic();
$storage->namespace = $declaring_class->getNamespaceName();
$class_storage->declaring_method_ids[$method_name] =
$declaring_class->name . '::' . strtolower((string)$method->getName());
$class_storage->inheritable_method_ids[$method_name] = $class_storage->declaring_method_ids[$method_name];
$class_storage->appearing_method_ids[$method_name] = $class_storage->declaring_method_ids[$method_name];
$class_storage->overridden_method_ids[$method_name] = [];
try {
$storage->return_type = FunctionChecker::getReturnTypeFromCallMap($method_id);
$storage->return_type->queueClassLikesForScanning($project_checker);
} catch (\InvalidArgumentException $e) {
// do nothing
}
$storage->visibility = $method->isPrivate()
? ClassLikeChecker::VISIBILITY_PRIVATE
: ($method->isProtected() ? ClassLikeChecker::VISIBILITY_PROTECTED : ClassLikeChecker::VISIBILITY_PUBLIC);
$possible_params = FunctionChecker::getParamsFromCallMap($method_id);
if ($possible_params === null) {
$params = $method->getParameters();
$storage->params = [];
/** @var \ReflectionParameter $param */
foreach ($params as $param) {
$param_array = self::getReflectionParamData($param);
$storage->params[] = $param_array;
$storage->param_types[$param->name] = $param_array->type;
}
} else {
foreach ($possible_params[0] as $param) {
if ($param->type) {
$param->type->queueClassLikesForScanning($project_checker);
}
}
$storage->params = $possible_params[0];
}
$storage->required_param_count = 0;
foreach ($storage->params as $i => $param) {
if (!$param->is_optional) {
$storage->required_param_count = $i + 1;
}
}
return null;
}
/**
* Determines whether a given method is static or not
*
* @param string $method_id
* @param bool $self_call
* @param CodeLocation $code_location
* @param array<string> $suppressed_issues
*
* @return bool
*/
public static function checkStatic(
$method_id,
$self_call,
ProjectChecker $project_checker,
CodeLocation $code_location,
array $suppressed_issues
) {
/** @var string */
$method_id = self::getDeclaringMethodId($project_checker, $method_id);
$storage = self::getStorage($project_checker, $method_id);
if (!$storage) {
throw new \UnexpectedValueException('$storage should not be null');
}
if (!$storage->is_static) {
if ($self_call) {
if (IssueBuffer::accepts(
new NonStaticSelfCall(
'Method ' . MethodChecker::getCasedMethodId($project_checker, $method_id) .
' is not static, but is called ' .
'using self::',
$code_location
),
$suppressed_issues
)) {
return false;
}
} else {
if (IssueBuffer::accepts(
new InvalidStaticInvocation(
'Method ' . MethodChecker::getCasedMethodId($project_checker, $method_id) .
' is not static, but is called ' .
'statically',
$code_location
),
$suppressed_issues
)) {
return false;
}
}
}
return true;
}
/**
* @param string $method_id
* @param CodeLocation $code_location
* @param array $suppressed_issues
*
* @return bool|null
*/
public static function checkMethodExists(
ProjectChecker $project_checker,
$method_id,
CodeLocation $code_location,
array $suppressed_issues
) {
if (self::methodExists($project_checker, $method_id, $code_location)) {
return true;
}
if (IssueBuffer::accepts(
new UndefinedMethod('Method ' . $method_id . ' does not exist', $code_location),
$suppressed_issues
)) {
return false;
}
return null;
}
/**
* Whether or not a given method exists
*
* @param string $method_id
* @param ProjectChecker $project_checker
* @param CodeLocation|null $code_location
*
* @return bool
*/
public static function methodExists(
ProjectChecker $project_checker,
$method_id,
CodeLocation $code_location = null
) {
// remove trailing backslash if it exists
$method_id = preg_replace('/^\\\\/', '', $method_id);
list($fq_class_name, $method_name) = explode('::', $method_id);
$method_name = strtolower($method_name);
$method_id = $fq_class_name . '::' . $method_name;
$old_method_id = null;
$class_storage = $project_checker->classlike_storage_provider->get($fq_class_name);
if (isset($class_storage->declaring_method_ids[$method_name])) {
if ($project_checker->collect_references && $code_location) {
$declaring_method_id = $class_storage->declaring_method_ids[$method_name];
list($declaring_method_class, $declaring_method_name) = explode('::', $declaring_method_id);
$declaring_class_storage = $project_checker->classlike_storage_provider->get($declaring_method_class);
$declaring_method_storage = $declaring_class_storage->methods[strtolower($declaring_method_name)];
if ($declaring_method_storage->referencing_locations === null) {
$declaring_method_storage->referencing_locations = [];
}
$declaring_method_storage->referencing_locations[$code_location->file_path][] = $code_location;
if (isset($declaring_class_storage->overridden_method_ids[$declaring_method_name])) {
$overridden_method_ids = $declaring_class_storage->overridden_method_ids[$declaring_method_name];
foreach ($overridden_method_ids as $overridden_method_id) {
list($overridden_method_class, $overridden_method_name) = explode('::', $overridden_method_id);
$class_storage = $project_checker->classlike_storage_provider->get($overridden_method_class);
$method_storage = $class_storage->methods[strtolower($overridden_method_name)];
if ($method_storage->referencing_locations === null) {
$method_storage->referencing_locations = [];
}
$method_storage->referencing_locations[$code_location->file_path][] = $code_location;
}
}
}
return true;
}
if ($class_storage->abstract && isset($class_storage->overridden_method_ids[$method_name])) {
return true;
}
// support checking oldstyle constructors
if ($method_name === '__construct') {
$method_name_parts = explode('\\', $fq_class_name);
$old_constructor_name = array_pop($method_name_parts);
$old_method_id = $fq_class_name . '::' . $old_constructor_name;
}
if (FunctionChecker::inCallMap($method_id) || ($old_method_id && FunctionChecker::inCallMap($method_id))) {
return true;
}
return false;
}
/**
* @param string $method_id
*
* @return MethodStorage
*/
public static function getStorage(ProjectChecker $project_checker, $method_id)
{
list($fq_class_name, $method_name) = explode('::', $method_id);
$class_storage = $project_checker->classlike_storage_provider->get($fq_class_name);
if (!isset($class_storage->methods[strtolower($method_name)])) {
throw new \UnexpectedValueException('$storage should not be null for ' . $method_id);
}
return $class_storage->methods[strtolower($method_name)];
}
/**
* @param string $method_id
* @param CodeLocation $code_location
* @param array $suppressed_issues
*
* @return false|null
*/
public static function checkMethodNotDeprecated(
ProjectChecker $project_checker,
$method_id,
CodeLocation $code_location,
array $suppressed_issues
) {
$method_id = (string) self::getDeclaringMethodId($project_checker, $method_id);
$storage = self::getStorage($project_checker, $method_id);
if ($storage->deprecated) {
if (IssueBuffer::accepts(
new DeprecatedMethod(
'The method ' . MethodChecker::getCasedMethodId($project_checker, $method_id) .
' has been marked as deprecated',
$code_location
),
$suppressed_issues
)) {
return false;
}
}
return null;
}
/**
* @param string $method_id
* @param string|null $calling_context
* @param StatementsSource $source
* @param CodeLocation $code_location
* @param array $suppressed_issues
*
* @return bool
*/
public static function isMethodVisible(
$method_id,
$calling_context,
StatementsSource $source
) {
$project_checker = $source->getFileChecker()->project_checker;
$declaring_method_id = self::getDeclaringMethodId($project_checker, $method_id);
if (!$declaring_method_id) {
$method_name = explode('::', $method_id)[1];
if ($method_name === '__construct') {
return true;
}
throw new \UnexpectedValueException('$declaring_method_id not expected to be null here');
}
$appearing_method_id = self::getAppearingMethodId($project_checker, $method_id);
$appearing_method_class = null;
if ($appearing_method_id) {
list($appearing_method_class) = explode('::', $appearing_method_id);
// if the calling class is the same, we know the method exists, so it must be visible
if ($appearing_method_class === $calling_context) {
return true;
}
}
list($declaring_method_class) = explode('::', $declaring_method_id);
if ($source->getSource() instanceof TraitChecker && $declaring_method_class === $source->getFQCLN()) {
return true;
}
$storage = self::getStorage($project_checker, $declaring_method_id);
if (!$storage) {
throw new \UnexpectedValueException('$storage should not be null for ' . $declaring_method_id);
}
switch ($storage->visibility) {
case ClassLikeChecker::VISIBILITY_PUBLIC:
return true;
case ClassLikeChecker::VISIBILITY_PRIVATE:
if (!$calling_context || $appearing_method_class !== $calling_context) {
return false;
}
return true;
case ClassLikeChecker::VISIBILITY_PROTECTED:
if (!$calling_context) {
return false;
}
if ($appearing_method_class
&& ClassChecker::classExtends($project_checker, $appearing_method_class, $calling_context)
) {
return true;
}
if ($appearing_method_class
&& !ClassChecker::classExtends($project_checker, $calling_context, $appearing_method_class)
) {
return false;
}
}
return true;
}
/**
* @param string $method_id
* @param string|null $calling_context
* @param StatementsSource $source
* @param CodeLocation $code_location
* @param array $suppressed_issues
*
* @return false|null
*/
public static function checkMethodVisibility(
$method_id,
$calling_context,
StatementsSource $source,
CodeLocation $code_location,
array $suppressed_issues
) {
$project_checker = $source->getFileChecker()->project_checker;
$declaring_method_id = self::getDeclaringMethodId($project_checker, $method_id);
if (!$declaring_method_id) {
$method_name = explode('::', $method_id)[1];
if ($method_name === '__construct') {
return null;
}
throw new \UnexpectedValueException('$declaring_method_id not expected to be null here');
}
$appearing_method_id = self::getAppearingMethodId($project_checker, $method_id);
$appearing_method_class = null;
if ($appearing_method_id) {
list($appearing_method_class) = explode('::', $appearing_method_id);
// if the calling class is the same, we know the method exists, so it must be visible
if ($appearing_method_class === $calling_context) {
return null;
}
}
list($declaring_method_class) = explode('::', $declaring_method_id);
if ($source->getSource() instanceof TraitChecker && $declaring_method_class === $source->getFQCLN()) {
return null;
}
$storage = self::getStorage($project_checker, $declaring_method_id);
if (!$storage) {
throw new \UnexpectedValueException('$storage should not be null for ' . $declaring_method_id);
}
switch ($storage->visibility) {
case ClassLikeChecker::VISIBILITY_PUBLIC:
return null;
case ClassLikeChecker::VISIBILITY_PRIVATE:
if (!$calling_context || $appearing_method_class !== $calling_context) {
if (IssueBuffer::accepts(
new InaccessibleMethod(
'Cannot access private method ' .
MethodChecker::getCasedMethodId($project_checker, $method_id) .
' from context ' . $calling_context,
$code_location
),
$suppressed_issues
)) {
return false;
}
}
return null;
case ClassLikeChecker::VISIBILITY_PROTECTED:
if (!$calling_context) {
if (IssueBuffer::accepts(
new InaccessibleMethod(
'Cannot access protected method ' . $method_id,
$code_location
),
$suppressed_issues
)) {
return false;
}
return null;
}
if ($appearing_method_class
&& ClassChecker::classExtends($project_checker, $appearing_method_class, $calling_context)
) {
return null;
}
if ($appearing_method_class
&& !ClassChecker::classExtends($project_checker, $calling_context, $appearing_method_class)
) {
if (IssueBuffer::accepts(
new InaccessibleMethod(
'Cannot access protected method ' .
MethodChecker::getCasedMethodId($project_checker, $method_id) .
' from context ' . $calling_context,
$code_location
),
$suppressed_issues
)) {
return false;
}
}
}
return null;
}
/**
* @param string $method_id
* @param string $declaring_method_id
*
* @return void
*/
public static function setDeclaringMethodId(
ProjectChecker $project_checker,
$method_id,
$declaring_method_id
) {
list($fq_class_name, $method_name) = explode('::', $method_id);
$class_storage = $project_checker->classlike_storage_provider->get($fq_class_name);
$class_storage->declaring_method_ids[$method_name] = $declaring_method_id;
}
/**
* @param string $method_id
* @param string $appearing_method_id
*
* @return void
*/
public static function setAppearingMethodId(ProjectChecker $project_checker, $method_id, $appearing_method_id)
{
list($fq_class_name, $method_name) = explode('::', $method_id);
$class_storage = $project_checker->classlike_storage_provider->get($fq_class_name);
$class_storage->appearing_method_ids[$method_name] = $appearing_method_id;
}
/**
* @param string $method_id
*
* @return string|null
*/
public static function getDeclaringMethodId(ProjectChecker $project_checker, $method_id)
{
$method_id = strtolower($method_id);
list($fq_class_name, $method_name) = explode('::', $method_id);
$class_storage = $project_checker->classlike_storage_provider->get($fq_class_name);
if (isset($class_storage->declaring_method_ids[$method_name])) {
return $class_storage->declaring_method_ids[$method_name];
}
if ($class_storage->abstract && isset($class_storage->overridden_method_ids[$method_name])) {
return $class_storage->overridden_method_ids[$method_name][0];
}
}
/**
* Get the class this method appears in (vs is declared in, which could give a trait)
*
* @param string $method_id
*
* @return string|null
*/
public static function getAppearingMethodId(ProjectChecker $project_checker, $method_id)
{
$method_id = strtolower($method_id);
list($fq_class_name, $method_name) = explode('::', $method_id);
$class_storage = $project_checker->classlike_storage_provider->get($fq_class_name);
if (isset($class_storage->appearing_method_ids[$method_name])) {
return $class_storage->appearing_method_ids[$method_name];
}
}
/**
* @param string $method_id
* @param string $overridden_method_id
*
* @return void
*/
public static function setOverriddenMethodId(ProjectChecker $project_checker, $method_id, $overridden_method_id)
{
list($fq_class_name, $method_name) = explode('::', $method_id);
$class_storage = $project_checker->classlike_storage_provider->get($fq_class_name);
$class_storage->overridden_method_ids[$method_name][] = $overridden_method_id;
}
/**
* @param string $method_id
*
* @return array<string>
*/
public static function getOverriddenMethodIds(ProjectChecker $project_checker, $method_id)
{
list($fq_class_name, $method_name) = explode('::', $method_id);
$class_storage = $project_checker->classlike_storage_provider->get($fq_class_name);
if (isset($class_storage->overridden_method_ids[$method_name])) {
return $class_storage->overridden_method_ids[$method_name];
}
return [];
}
/**
* @param string $original_method_id
*
* @return string
*/
public static function getCasedMethodId(ProjectChecker $project_checker, $original_method_id)
{
$method_id = self::getDeclaringMethodId($project_checker, $original_method_id);
if ($method_id === null) {
throw new \UnexpectedValueException('Cannot get declaring method id for ' . $original_method_id);
}
$storage = self::getStorage($project_checker, $method_id);
if (!$storage) {
throw new \UnexpectedValueException('$storage should not be null for ' . $method_id);
}
list($fq_class_name) = explode('::', $method_id);
return $fq_class_name . '::' . $storage->cased_name;
}
}