2022-01-13 13:02:46 +00:00
|
|
|
<?php
|
|
|
|
|
|
|
|
declare (strict_types=1);
|
2022-06-06 17:12:56 +00:00
|
|
|
namespace Rector\Php81\Rector\FuncCall;
|
2022-01-13 13:02:46 +00:00
|
|
|
|
2022-06-06 17:12:56 +00:00
|
|
|
use PhpParser\Node;
|
|
|
|
use PhpParser\Node\Arg;
|
|
|
|
use PhpParser\Node\Expr;
|
|
|
|
use PhpParser\Node\Expr\Assign;
|
|
|
|
use PhpParser\Node\Expr\Cast\String_ as CastString_;
|
|
|
|
use PhpParser\Node\Expr\ConstFetch;
|
|
|
|
use PhpParser\Node\Expr\FuncCall;
|
|
|
|
use PhpParser\Node\Expr\MethodCall;
|
|
|
|
use PhpParser\Node\Identifier;
|
2022-08-09 20:47:13 +00:00
|
|
|
use PhpParser\Node\Scalar\Encapsed;
|
2022-06-06 17:12:56 +00:00
|
|
|
use PhpParser\Node\Scalar\String_;
|
|
|
|
use PHPStan\Analyser\Scope;
|
2022-12-10 12:49:18 +00:00
|
|
|
use PHPStan\Reflection\ClassReflection;
|
2022-06-06 17:12:56 +00:00
|
|
|
use PHPStan\Reflection\Native\NativeFunctionReflection;
|
|
|
|
use PHPStan\Type\ErrorType;
|
|
|
|
use PHPStan\Type\MixedType;
|
2023-02-15 15:21:14 +00:00
|
|
|
use PHPStan\Type\NullType;
|
|
|
|
use PHPStan\Type\Type;
|
2022-06-06 17:12:56 +00:00
|
|
|
use Rector\Core\NodeAnalyzer\ArgsAnalyzer;
|
2022-12-10 15:34:03 +00:00
|
|
|
use Rector\Core\NodeAnalyzer\PropertyFetchAnalyzer;
|
2022-12-10 12:49:18 +00:00
|
|
|
use Rector\Core\Rector\AbstractScopeAwareRector;
|
2022-06-06 17:12:56 +00:00
|
|
|
use Rector\Core\Reflection\ReflectionResolver;
|
|
|
|
use Rector\Core\ValueObject\PhpVersionFeature;
|
2022-07-02 21:18:00 +00:00
|
|
|
use Rector\NodeTypeResolver\PHPStan\ParametersAcceptorSelectorVariantsWrapper;
|
2022-06-06 17:12:56 +00:00
|
|
|
use Rector\VersionBonding\Contract\MinPhpVersionInterface;
|
2022-06-07 09:18:30 +00:00
|
|
|
use Symplify\RuleDocGenerator\ValueObject\CodeSample\CodeSample;
|
|
|
|
use Symplify\RuleDocGenerator\ValueObject\RuleDefinition;
|
2022-01-13 13:02:46 +00:00
|
|
|
/**
|
|
|
|
* @see \Rector\Tests\Php81\Rector\FuncCall\NullToStrictStringFuncCallArgRector\NullToStrictStringFuncCallArgRectorTest
|
|
|
|
*/
|
2022-12-10 12:49:18 +00:00
|
|
|
final class NullToStrictStringFuncCallArgRector extends AbstractScopeAwareRector implements MinPhpVersionInterface
|
2022-01-13 13:02:46 +00:00
|
|
|
{
|
|
|
|
/**
|
|
|
|
* @var array<string, string[]>
|
|
|
|
*/
|
2022-11-11 11:46:13 +00:00
|
|
|
private const ARG_POSITION_NAME_NULL_TO_STRICT_STRING = ['preg_split' => ['subject'], 'preg_match' => ['subject'], 'preg_match_all' => ['subject'], 'preg_filter' => ['replacement', 'subject'], 'preg_replace' => ['replacement', 'subject'], 'preg_replace_callback' => ['subject'], 'preg_replace_callback_array' => ['subject'], 'explode' => ['string'], 'strlen' => ['string'], 'str_contains' => ['haystack', 'needle'], 'strtotime' => ['datetime'], 'str_replace' => ['subject'], 'substr_replace' => ['string', 'replace'], 'str_ireplace' => ['search', 'replace', 'subject'], 'substr' => ['string'], 'str_starts_with' => ['haystack', 'needle'], 'strtoupper' => ['string'], 'strtolower' => ['string'], 'strpos' => ['haystack', 'needle'], 'stripos' => ['haystack', 'needle'], 'json_decode' => ['json'], 'urlencode' => ['string'], 'urldecode' => ['string'], 'rawurlencode' => ['string'], 'rawurldecode' => ['string'], 'base64_encode' => ['string'], 'base64_decode' => ['string'], 'utf8_encode' => ['string'], 'utf8_decode' => ['string'], 'bin2hex' => ['string'], 'hex2bin' => ['string'], 'hexdec' => ['hex_string'], 'octdec' => ['octal_string'], 'base_convert' => ['num'], 'htmlspecialchars' => ['string'], 'htmlspecialchars_decode' => ['string'], 'html_entity_decode' => ['string'], 'htmlentities' => ['string'], 'addslashes' => ['string'], 'addcslashes' => ['string', 'characters'], 'stripslashes' => ['string'], 'stripcslashes' => ['string'], 'quotemeta' => ['string'], 'quoted_printable_decode' => ['string'], 'quoted_printable_encode' => ['string'], 'escapeshellarg' => ['arg'], 'curl_escape' => ['string'], 'curl_unescape' => ['string'], 'convert_uuencode' => ['string'], 'setcookie' => ['value', 'path', 'domain'], 'setrawcookie' => ['value', 'path', 'domain'], 'zlib_encode' => ['data'], 'gzdeflate' => ['data'], 'gzencode' => ['data'], 'gzcompress' => ['data'], 'gzwrite' => ['data'], 'gzputs' => ['data'], 'deflate_add' => ['data'], 'inflate_add' => ['data'], 'unpack' => ['format', 'string'], 'iconv_mime_encode' => ['field_name', 'field_value'], 'iconv_mime_decode' => ['string'], 'iconv' => ['from_encoding', 'to_encoding', 'string'], 'sodium_bin2hex' => ['string'], 'sodium_hex2bin' => ['string', 'ignore'], 'sodium_bin2base64' => ['string'], 'sodium_base642bin' => ['string', 'ignore'], 'mb_detect_encoding' => ['string'], 'mb_encode_mimeheader' => ['string'], 'mb_decode_mimeheader' => ['string'], 'mb_encode_numericentity' => ['string'], 'mb_decode_numericentity' => ['string'], 'transliterator_transliterate' => ['string'], 'mysqli_real_escape_string' => ['string'], 'mysqli_escape_string' => ['string'], 'pg_escape_bytea' => ['string'], 'pg_escape_literal' => ['string'], 'pg_escape_string' => ['string'], 'pg_unescape_bytea' => ['string'], 'ucfirst' => ['string'], 'lcfirst' => ['string'], 'ucwords' => ['string'], 'trim' => ['string'], 'ltrim' => ['string'], 'rtrim' => ['string'], 'chop' => ['string'], 'str_rot13' => ['string'], 'str_shuffle' => ['string'], 'substr_count' => ['haystack', 'needle'], 'strcoll' => ['string1', 'string2'], 'str_split' => ['string'], 'chunk_split' => ['string'], 'wordwrap' => ['string'], 'strrev' => ['string'], 'str_repeat' => ['string'], 'str_pad' => ['string'], 'nl2br' => ['string'], 'strip_tags' => ['string'], 'hebrev' => ['string'], 'iconv_substr' => ['string'], 'mb_strtoupper' => ['string'], 'mb_strtolower' => ['string'], 'mb_convert_case' => ['string'], 'mb_convert_kana' => ['string'], 'mb_convert_encoding' => ['string'], 'mb_scrub' => ['string'], 'mb_substr' => ['string'], 'mb_substr_count' => ['haystack', 'needle'], 'mb_str_split' => ['string'], 'mb_split' => ['pattern', 'string'], 'sodium_pad' => ['string'], 'grapheme_substr' => ['string'], 'strrpos' => ['haystack', 'needle'], 'strripos' => ['haystack', 'needle'], 'iconv_strpos' => ['haystack', 'needle'], 'iconv_strrpos' => ['haystack', 'needle'], 'mb_strpos' => ['haystack', 'needle'], 'mb_strrpos' => ['haystack', 'needle'], 'mb_stripos' => ['haystack', 'needle'], 'mb_strripos' => ['haystack', 'needle'], 'grapheme_extract' => ['haystack'], 'grapheme_strpos' => ['haysta
|
2022-01-13 13:02:46 +00:00
|
|
|
/**
|
|
|
|
* @readonly
|
|
|
|
* @var \Rector\Core\Reflection\ReflectionResolver
|
|
|
|
*/
|
|
|
|
private $reflectionResolver;
|
|
|
|
/**
|
|
|
|
* @readonly
|
|
|
|
* @var \Rector\Core\NodeAnalyzer\ArgsAnalyzer
|
|
|
|
*/
|
|
|
|
private $argsAnalyzer;
|
2022-12-10 15:34:03 +00:00
|
|
|
/**
|
|
|
|
* @readonly
|
|
|
|
* @var \Rector\Core\NodeAnalyzer\PropertyFetchAnalyzer
|
|
|
|
*/
|
|
|
|
private $propertyFetchAnalyzer;
|
|
|
|
public function __construct(ReflectionResolver $reflectionResolver, ArgsAnalyzer $argsAnalyzer, PropertyFetchAnalyzer $propertyFetchAnalyzer)
|
2022-01-13 13:02:46 +00:00
|
|
|
{
|
|
|
|
$this->reflectionResolver = $reflectionResolver;
|
|
|
|
$this->argsAnalyzer = $argsAnalyzer;
|
2022-12-10 15:34:03 +00:00
|
|
|
$this->propertyFetchAnalyzer = $propertyFetchAnalyzer;
|
2022-01-13 13:02:46 +00:00
|
|
|
}
|
2022-06-07 08:22:29 +00:00
|
|
|
public function getRuleDefinition() : RuleDefinition
|
2022-01-13 13:02:46 +00:00
|
|
|
{
|
2022-06-07 08:22:29 +00:00
|
|
|
return new RuleDefinition('Change null to strict string defined function call args', [new CodeSample(<<<'CODE_SAMPLE'
|
2022-01-13 13:02:46 +00:00
|
|
|
class SomeClass
|
|
|
|
{
|
|
|
|
public function run()
|
|
|
|
{
|
|
|
|
preg_split("#a#", null);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
CODE_SAMPLE
|
|
|
|
, <<<'CODE_SAMPLE'
|
|
|
|
class SomeClass
|
|
|
|
{
|
|
|
|
public function run()
|
|
|
|
{
|
|
|
|
preg_split("#a#", '');
|
|
|
|
}
|
|
|
|
}
|
|
|
|
CODE_SAMPLE
|
|
|
|
)]);
|
|
|
|
}
|
|
|
|
/**
|
|
|
|
* @return array<class-string<Node>>
|
|
|
|
*/
|
|
|
|
public function getNodeTypes() : array
|
|
|
|
{
|
2022-06-07 08:22:29 +00:00
|
|
|
return [FuncCall::class];
|
2022-01-13 13:02:46 +00:00
|
|
|
}
|
|
|
|
/**
|
|
|
|
* @param FuncCall $node
|
|
|
|
*/
|
2022-12-10 12:49:18 +00:00
|
|
|
public function refactorWithScope(Node $node, Scope $scope) : ?Node
|
2022-01-13 13:02:46 +00:00
|
|
|
{
|
2022-12-10 15:34:03 +00:00
|
|
|
if ($this->shouldSkip($node)) {
|
2022-01-13 13:02:46 +00:00
|
|
|
return null;
|
|
|
|
}
|
|
|
|
$args = $node->getArgs();
|
2023-05-10 18:50:31 +00:00
|
|
|
$positions = $this->argsAnalyzer->hasNamedArg($args) ? $this->resolveNamedPositions($node, $args) : $this->resolveOriginalPositions($node, $scope);
|
2022-01-13 13:02:46 +00:00
|
|
|
if ($positions === []) {
|
|
|
|
return null;
|
|
|
|
}
|
2022-12-10 15:34:03 +00:00
|
|
|
$classReflection = $scope->getClassReflection();
|
|
|
|
$isTrait = $classReflection instanceof ClassReflection && $classReflection->isTrait();
|
2022-01-13 13:02:46 +00:00
|
|
|
$isChanged = \false;
|
|
|
|
foreach ($positions as $position) {
|
2023-05-10 18:50:31 +00:00
|
|
|
$result = $this->processNullToStrictStringOnNodePosition($node, $args, $position, $isTrait, $scope);
|
2022-06-07 08:22:29 +00:00
|
|
|
if ($result instanceof Node) {
|
2022-01-13 13:02:46 +00:00
|
|
|
$node = $result;
|
|
|
|
$isChanged = \true;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
if ($isChanged) {
|
|
|
|
return $node;
|
|
|
|
}
|
|
|
|
return null;
|
|
|
|
}
|
|
|
|
public function provideMinPhpVersion() : int
|
|
|
|
{
|
2022-06-07 08:22:29 +00:00
|
|
|
return PhpVersionFeature::DEPRECATE_NULL_ARG_IN_STRING_FUNCTION;
|
2022-01-13 13:02:46 +00:00
|
|
|
}
|
|
|
|
/**
|
|
|
|
* @param Arg[] $args
|
|
|
|
* @return int[]|string[]
|
|
|
|
*/
|
2022-06-07 08:22:29 +00:00
|
|
|
private function resolveNamedPositions(FuncCall $funcCall, array $args) : array
|
2022-01-13 13:02:46 +00:00
|
|
|
{
|
|
|
|
$functionName = $this->nodeNameResolver->getName($funcCall);
|
|
|
|
$argNames = self::ARG_POSITION_NAME_NULL_TO_STRICT_STRING[$functionName];
|
|
|
|
$positions = [];
|
|
|
|
foreach ($args as $position => $arg) {
|
2022-06-07 08:22:29 +00:00
|
|
|
if (!$arg->name instanceof Identifier) {
|
2022-01-13 13:02:46 +00:00
|
|
|
continue;
|
|
|
|
}
|
|
|
|
if (!$this->nodeNameResolver->isNames($arg->name, $argNames)) {
|
|
|
|
continue;
|
|
|
|
}
|
|
|
|
$positions[] = $position;
|
|
|
|
}
|
|
|
|
return $positions;
|
|
|
|
}
|
|
|
|
/**
|
|
|
|
* @param Arg[] $args
|
|
|
|
* @param int|string $position
|
|
|
|
*/
|
2023-05-10 18:50:31 +00:00
|
|
|
private function processNullToStrictStringOnNodePosition(FuncCall $funcCall, array $args, $position, bool $isTrait, Scope $scope) : ?FuncCall
|
2022-01-13 13:02:46 +00:00
|
|
|
{
|
2022-08-15 18:34:46 +00:00
|
|
|
if (!isset($args[$position])) {
|
|
|
|
return null;
|
|
|
|
}
|
2022-01-13 13:02:46 +00:00
|
|
|
$argValue = $args[$position]->value;
|
2022-06-07 08:22:29 +00:00
|
|
|
if ($argValue instanceof ConstFetch && $this->valueResolver->isNull($argValue)) {
|
|
|
|
$args[$position]->value = new String_('');
|
2022-01-13 13:02:46 +00:00
|
|
|
$funcCall->args = $args;
|
|
|
|
return $funcCall;
|
|
|
|
}
|
|
|
|
$type = $this->nodeTypeResolver->getType($argValue);
|
2022-11-12 09:58:36 +00:00
|
|
|
if ($type->isString()->yes()) {
|
2022-01-13 13:02:46 +00:00
|
|
|
return null;
|
|
|
|
}
|
2023-02-15 15:21:14 +00:00
|
|
|
if (!$type instanceof MixedType && !$type instanceof NullType) {
|
|
|
|
return null;
|
|
|
|
}
|
|
|
|
if ($argValue instanceof Encapsed) {
|
2022-08-09 20:47:13 +00:00
|
|
|
return null;
|
|
|
|
}
|
2023-05-10 18:50:31 +00:00
|
|
|
if ($this->isAnErrorTypeFromParentScope($argValue, $scope)) {
|
2022-01-13 13:02:46 +00:00
|
|
|
return null;
|
|
|
|
}
|
2022-12-17 14:48:31 +00:00
|
|
|
if ($this->shouldSkipTrait($argValue, $type, $isTrait)) {
|
2022-12-10 15:34:03 +00:00
|
|
|
return null;
|
2022-01-13 13:02:46 +00:00
|
|
|
}
|
|
|
|
if ($this->isCastedReassign($argValue)) {
|
|
|
|
return null;
|
|
|
|
}
|
2022-06-07 08:22:29 +00:00
|
|
|
$args[$position]->value = new CastString_($argValue);
|
2022-01-13 13:02:46 +00:00
|
|
|
$funcCall->args = $args;
|
|
|
|
return $funcCall;
|
|
|
|
}
|
2023-02-15 15:21:14 +00:00
|
|
|
private function shouldSkipTrait(Expr $expr, Type $type, bool $isTrait) : bool
|
2022-12-10 15:34:03 +00:00
|
|
|
{
|
2023-02-15 15:21:14 +00:00
|
|
|
if (!$type instanceof MixedType) {
|
|
|
|
return \false;
|
|
|
|
}
|
2022-12-17 14:48:31 +00:00
|
|
|
if (!$isTrait) {
|
|
|
|
return \false;
|
|
|
|
}
|
2023-02-15 15:21:14 +00:00
|
|
|
if ($type->isExplicitMixed()) {
|
2022-12-17 14:48:31 +00:00
|
|
|
return \false;
|
|
|
|
}
|
2022-12-10 15:34:03 +00:00
|
|
|
if (!$expr instanceof MethodCall) {
|
2022-12-17 14:48:31 +00:00
|
|
|
return $this->propertyFetchAnalyzer->isLocalPropertyFetch($expr);
|
2022-12-10 15:34:03 +00:00
|
|
|
}
|
2022-12-17 14:48:31 +00:00
|
|
|
return \true;
|
2022-12-10 15:34:03 +00:00
|
|
|
}
|
2022-06-07 08:22:29 +00:00
|
|
|
private function isCastedReassign(Expr $expr) : bool
|
2022-01-13 13:02:46 +00:00
|
|
|
{
|
2022-06-07 08:22:29 +00:00
|
|
|
return (bool) $this->betterNodeFinder->findFirstPrevious($expr, function (Node $subNode) use($expr) : bool {
|
|
|
|
if (!$subNode instanceof Assign) {
|
2022-01-13 13:02:46 +00:00
|
|
|
return \false;
|
|
|
|
}
|
|
|
|
if (!$this->nodeComparator->areNodesEqual($subNode->var, $expr)) {
|
|
|
|
return \false;
|
|
|
|
}
|
2022-06-07 08:22:29 +00:00
|
|
|
return $subNode->expr instanceof CastString_;
|
2022-01-13 13:02:46 +00:00
|
|
|
});
|
|
|
|
}
|
2023-05-10 18:50:31 +00:00
|
|
|
private function isAnErrorTypeFromParentScope(Expr $expr, Scope $scope) : bool
|
2022-01-13 13:02:46 +00:00
|
|
|
{
|
|
|
|
$parentScope = $scope->getParentScope();
|
2022-06-07 08:22:29 +00:00
|
|
|
if ($parentScope instanceof Scope) {
|
|
|
|
return $parentScope->getType($expr) instanceof ErrorType;
|
2022-01-13 13:02:46 +00:00
|
|
|
}
|
|
|
|
return \false;
|
|
|
|
}
|
|
|
|
/**
|
|
|
|
* @return int[]|string[]
|
|
|
|
*/
|
2023-05-10 18:50:31 +00:00
|
|
|
private function resolveOriginalPositions(FuncCall $funcCall, Scope $scope) : array
|
2022-01-13 13:02:46 +00:00
|
|
|
{
|
|
|
|
$functionReflection = $this->reflectionResolver->resolveFunctionLikeReflectionFromCall($funcCall);
|
2022-06-07 08:22:29 +00:00
|
|
|
if (!$functionReflection instanceof NativeFunctionReflection) {
|
2022-01-13 13:02:46 +00:00
|
|
|
return [];
|
|
|
|
}
|
2022-07-05 07:33:24 +00:00
|
|
|
$parametersAcceptor = ParametersAcceptorSelectorVariantsWrapper::select($functionReflection, $funcCall, $scope);
|
2022-09-24 08:51:57 +00:00
|
|
|
$functionName = $functionReflection->getName();
|
2022-01-13 13:02:46 +00:00
|
|
|
$argNames = self::ARG_POSITION_NAME_NULL_TO_STRICT_STRING[$functionName];
|
|
|
|
$positions = [];
|
|
|
|
foreach ($parametersAcceptor->getParameters() as $position => $parameterReflection) {
|
|
|
|
if (\in_array($parameterReflection->getName(), $argNames, \true)) {
|
|
|
|
$positions[] = $position;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return $positions;
|
|
|
|
}
|
2022-12-10 15:34:03 +00:00
|
|
|
private function shouldSkip(FuncCall $funcCall) : bool
|
2022-01-13 13:02:46 +00:00
|
|
|
{
|
|
|
|
$functionNames = \array_keys(self::ARG_POSITION_NAME_NULL_TO_STRICT_STRING);
|
2022-09-11 12:05:24 +00:00
|
|
|
if (!$this->nodeNameResolver->isNames($funcCall, $functionNames)) {
|
|
|
|
return \true;
|
|
|
|
}
|
|
|
|
return $funcCall->isFirstClassCallable();
|
2022-01-13 13:02:46 +00:00
|
|
|
}
|
|
|
|
}
|