1: <?php declare(strict_types = 1);
2:
3: namespace PHPStan\Rules\RestrictedUsage;
4:
5: use PhpParser\Node;
6: use PhpParser\Node\Name;
7: use PHPStan\Analyser\Scope;
8: use PHPStan\DependencyInjection\AutowiredService;
9: use PHPStan\DependencyInjection\Container;
10: use PHPStan\Node\FunctionCallableNode;
11: use PHPStan\Reflection\ReflectionProvider;
12: use PHPStan\Rules\Rule;
13: use PHPStan\Rules\RuleErrorBuilder;
14:
15: /**
16: * @implements Rule<FunctionCallableNode>
17: */
18: #[AutowiredService]
19: final class RestrictedFunctionCallableUsageRule implements Rule
20: {
21:
22: /** @var RestrictedFunctionUsageExtension[] $extensions */
23: private ?array $extensions = null;
24:
25: public function __construct(
26: private Container $container,
27: private ReflectionProvider $reflectionProvider,
28: )
29: {
30: }
31:
32: public function getNodeType(): string
33: {
34: return FunctionCallableNode::class;
35: }
36:
37: /**
38: * @api
39: */
40: public function processNode(Node $node, Scope $scope): array
41: {
42: if (!($node->getName() instanceof Name)) {
43: return [];
44: }
45:
46: if (!$this->reflectionProvider->hasFunction($node->getName(), $scope)) {
47: return [];
48: }
49:
50: $functionReflection = $this->reflectionProvider->getFunction($node->getName(), $scope);
51:
52: /** @var RestrictedFunctionUsageExtension[] $extensions */
53: $extensions = $this->extensions ??= $this->container->getServicesByTag(RestrictedFunctionUsageExtension::FUNCTION_EXTENSION_TAG);
54: $errors = [];
55:
56: foreach ($extensions as $extension) {
57: $restrictedUsage = $extension->isRestrictedFunctionUsage($functionReflection, $scope);
58: if ($restrictedUsage === null) {
59: continue;
60: }
61:
62: $errors[] = RuleErrorBuilder::message($restrictedUsage->errorMessage)
63: ->identifier($restrictedUsage->identifier)
64: ->build();
65: }
66:
67: return $errors;
68: }
69:
70: }
71: