allow_includes) { throw new FileIncludeException( 'File includes are not allowed per your Psalm config - check the allowFileIncludes flag.' ); } if (ExpressionChecker::analyze($statements_checker, $stmt->expr, $context) === false) { return false; } if ($stmt->expr instanceof PhpParser\Node\Scalar\String_ || (isset($stmt->expr->inferredType) && $stmt->expr->inferredType->isSingleStringLiteral()) ) { if ($stmt->expr instanceof PhpParser\Node\Scalar\String_) { $path_to_file = $stmt->expr->value; } else { $path_to_file = $stmt->expr->inferredType->getSingleStringLiteral()->value; } $path_to_file = str_replace('/', DIRECTORY_SEPARATOR, $path_to_file); // attempts to resolve using get_include_path dirs $include_path = self::resolveIncludePath($path_to_file, dirname($statements_checker->getFileName())); $path_to_file = $include_path ? $include_path : $path_to_file; if (DIRECTORY_SEPARATOR === '/') { $is_path_relative = $path_to_file[0] !== DIRECTORY_SEPARATOR; } else { $is_path_relative = !preg_match('~^[A-Z]:\\\\~i', $path_to_file); } if ($is_path_relative) { $path_to_file = getcwd() . DIRECTORY_SEPARATOR . $path_to_file; } } else { $path_to_file = self::getPathTo($stmt->expr, $statements_checker->getFileName()); } if ($path_to_file) { $path_to_file = preg_replace('/\/[\/]+/', '/', $path_to_file); $path_to_file = str_replace('/./', '/', $path_to_file); $slash = preg_quote(DIRECTORY_SEPARATOR, '/'); $reduce_pattern = '/' . $slash . '[^' . $slash . ']+' . $slash . '\.\.' . $slash . '/'; while (preg_match($reduce_pattern, $path_to_file)) { $path_to_file = preg_replace($reduce_pattern, DIRECTORY_SEPARATOR, $path_to_file); } // if the file is already included, we can't check much more if (in_array(realpath($path_to_file), get_included_files(), true)) { return null; } $current_file_checker = $statements_checker->getFileChecker(); if ($current_file_checker->project_checker->fileExists($path_to_file)) { $codebase = $current_file_checker->project_checker->codebase; if ($statements_checker->hasParentFilePath($path_to_file) || ($statements_checker->hasAlreadyRequiredFilePath($path_to_file) && !$codebase->file_storage_provider->get($path_to_file)->has_extra_statements) ) { return null; } $current_file_checker->addRequiredFilePath($path_to_file); $file_name = $config->shortenFileName($path_to_file); if ($current_file_checker->project_checker->debug_output) { $nesting = $statements_checker->getRequireNesting() + 1; echo (str_repeat(' ', $nesting) . 'checking ' . $file_name . PHP_EOL); } $include_file_checker = new \Psalm\Checker\FileChecker( $current_file_checker->project_checker, $path_to_file, $file_name ); $include_file_checker->setRootFilePath( $current_file_checker->getRootFilePath(), $current_file_checker->getRootFileName() ); $include_file_checker->addParentFilePath($current_file_checker->getFilePath()); $include_file_checker->addRequiredFilePath($current_file_checker->getFilePath()); foreach ($current_file_checker->getRequiredFilePaths() as $required_file_path) { $include_file_checker->addRequiredFilePath($required_file_path); } foreach ($current_file_checker->getParentFilePaths() as $parent_file_path) { $include_file_checker->addParentFilePath($parent_file_path); } try { $include_file_checker->analyze( $context, false, $global_context ); } catch (\Psalm\Exception\UnpreparedAnalysisException $e) { $context->check_classes = false; $context->check_variables = false; $context->check_functions = false; } foreach ($include_file_checker->getRequiredFilePaths() as $required_file_path) { $current_file_checker->addRequiredFilePath($required_file_path); } return null; } $source = $statements_checker->getSource(); if (IssueBuffer::accepts( new MissingFile( 'Cannot find file ' . $path_to_file . ' to include', new CodeLocation($source, $stmt) ), $source->getSuppressedIssues() )) { // fall through } } else { $var_id = ExpressionChecker::getArrayVarId($stmt->expr, null); if (!$var_id || !isset($context->phantom_files[$var_id])) { $source = $statements_checker->getSource(); if (IssueBuffer::accepts( new UnresolvableInclude( 'Cannot resolve the given expression to a file path', new CodeLocation($source, $stmt) ), $source->getSuppressedIssues() )) { // fall through } } } $context->check_classes = false; $context->check_variables = false; $context->check_functions = false; return null; } /** * @param PhpParser\Node\Expr $stmt * @param string $file_name * * @return string|null * @psalm-suppress MixedAssignment */ public static function getPathTo(PhpParser\Node\Expr $stmt, $file_name) { if (DIRECTORY_SEPARATOR === '/') { $is_path_relative = $file_name[0] !== DIRECTORY_SEPARATOR; } else { $is_path_relative = !preg_match('~^[A-Z]:\\\\~i', $file_name); } if ($is_path_relative) { $file_name = getcwd() . DIRECTORY_SEPARATOR . $file_name; } if ($stmt instanceof PhpParser\Node\Scalar\String_) { return $stmt->value; } if (isset($stmt->inferredType) && $stmt->inferredType->isSingleStringLiteral()) { return $stmt->inferredType->getSingleStringLiteral()->value; } if ($stmt instanceof PhpParser\Node\Expr\ArrayDimFetch) { if ($stmt->var instanceof PhpParser\Node\Expr\Variable && $stmt->var->name === 'GLOBALS' && $stmt->dim instanceof PhpParser\Node\Scalar\String_ ) { if (isset($GLOBALS[$stmt->dim->value]) && is_string($GLOBALS[$stmt->dim->value])) { /** @var string */ return $GLOBALS[$stmt->dim->value]; } } } elseif ($stmt instanceof PhpParser\Node\Expr\BinaryOp\Concat) { $left_string = self::getPathTo($stmt->left, $file_name); $right_string = self::getPathTo($stmt->right, $file_name); if ($left_string && $right_string) { return $left_string . $right_string; } } elseif ($stmt instanceof PhpParser\Node\Expr\FuncCall && $stmt->name instanceof PhpParser\Node\Name && $stmt->name->parts === ['dirname'] ) { if ($stmt->args) { $dir_level = 1; if (isset($stmt->args[1])) { if ($stmt->args[1]->value instanceof PhpParser\Node\Scalar\LNumber) { $dir_level = $stmt->args[1]->value->value; } else { return null; } } $evaled_path = self::getPathTo($stmt->args[0]->value, $file_name); if (!$evaled_path) { return null; } return dirname($evaled_path, $dir_level); } } elseif ($stmt instanceof PhpParser\Node\Expr\ConstFetch && $stmt->name instanceof PhpParser\Node\Name) { $const_name = implode('', $stmt->name->parts); if (defined($const_name)) { $constant_value = constant($const_name); if (is_string($constant_value)) { return $constant_value; } } } elseif ($stmt instanceof PhpParser\Node\Scalar\MagicConst\Dir) { return dirname($file_name); } elseif ($stmt instanceof PhpParser\Node\Scalar\MagicConst\File) { return $file_name; } return null; } /** * @param string $file_name * @param string $current_directory * * @return string|null */ public static function resolveIncludePath($file_name, $current_directory) { if (!$current_directory) { return $file_name; } $paths = PATH_SEPARATOR == ':' ? preg_split('#(?