1: <?php declare(strict_types = 1);
2:
3: namespace PHPStan\Type;
4:
5: use PhpParser\Node\Expr\FuncCall;
6: use PHPStan\Analyser\Scope;
7: use PHPStan\Broker\BrokerFactory;
8: use PHPStan\DependencyInjection\ExtensionInterface;
9: use PHPStan\Reflection\FunctionReflection;
10:
11: /**
12: * This is the interface dynamic return type extensions implement for functions.
13: *
14: * To register it in the configuration file use the `phpstan.broker.dynamicFunctionReturnTypeExtension` service tag:
15: *
16: * ```
17: * services:
18: * -
19: * class: App\PHPStan\MyExtension
20: * tags:
21: * - phpstan.broker.dynamicFunctionReturnTypeExtension
22: * ```
23: *
24: * Learn more: https://phpstan.org/developing-extensions/dynamic-return-type-extensions
25: *
26: * @api
27: */
28: #[ExtensionInterface(tag: BrokerFactory::DYNAMIC_FUNCTION_RETURN_TYPE_EXTENSION_TAG)]
29: interface DynamicFunctionReturnTypeExtension
30: {
31:
32: public function isFunctionSupported(FunctionReflection $functionReflection): bool;
33:
34: public function getTypeFromFunctionCall(FunctionReflection $functionReflection, FuncCall $functionCall, Scope $scope): ?Type;
35:
36: }
37: